A GitHub Action for running AI-powered task automation within your workflows.

• ✅ Free for public repositories
• 💼 Premium plan coming for private repositories

• ⚙️ AI-driven task execution via OpenAI or custom models
• 🔐 Secure environment variable handling (OPENAI_API_KEY, GITHUB_TOKEN)
• 🆓 Free tier for public repositories
• 🚀 Extensible with custom agents via built-in SDK
• 🔧 Supports JSON input directly or via file
• 📈 Ideal for automating repetitive workflows with intelligence

💡 Premium version will be available on GitHub Marketplace.

Add the action to your GitHub Actions workflow (see below).

• A GitHub repository with Actions enabled
• GitHub Secret: OPENAI_API_KEY

name: Run AI Agent

on:
  push:
    branches:
      - main

jobs:
  ai-agent:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Run AI Agent Action
        uses: your-username/your-repo@v1
        with:
          task-input: '{"input": "Hello, AI Agent!"}'
          openai-api-key: ${{ secrets.OPENAI_API_KEY }}
          agent-name: MyAIAgent
          log-level: DEBUG
        id: ai-agent

      - name: Print Result
        run: echo "Result: ${{ steps.ai-agent.outputs.result }}"

Want to go further? Build custom agents by subclassing AIAgentSDK — full source available in this repository.

Example:

from ai_agent_sdk import AIAgentSDK

class MyCustomAgent(AIAgentSDK):
    def execute_task(self, task):
        return {
            'status': 'success',
            'result': f"Custom result for input: {task.get('input')}"
        }

• Free for public repositories ✔️
• $5/month per private repo (soon)

Bug reports, ideas, or pull requests are welcome! Submit an issue or PR on GitHub.

MIT License