{"id":28919305,"url":"https://github.com/algenix-org/agent-sdk","last_synced_at":"2025-08-25T19:07:57.022Z","repository":{"id":299798172,"uuid":"1002923854","full_name":"Algenix-Org/agent-sdk","owner":"Algenix-Org","description":"AI Agent Custom SDK","archived":false,"fork":false,"pushed_at":"2025-08-01T11:33:38.000Z","size":170,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-01T13:44:14.491Z","etag":null,"topics":["agenticalliance","ai","ai-agent","github-actions","github-marketplace","open-source"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Algenix-Org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-16T10:58:23.000Z","updated_at":"2025-08-01T11:28:57.000Z","dependencies_parsed_at":"2025-08-01T13:25:52.738Z","dependency_job_id":null,"html_url":"https://github.com/Algenix-Org/agent-sdk","commit_stats":null,"previous_names":["algenix-org/agent-sdk"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Algenix-Org/agent-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Algenix-Org%2Fagent-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Algenix-Org%2Fagent-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Algenix-Org%2Fagent-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Algenix-Org%2Fagent-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Algenix-Org","download_url":"https://codeload.github.com/Algenix-Org/agent-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Algenix-Org%2Fagent-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272117066,"owners_count":24876312,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-25T02:00:12.092Z","response_time":1107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agenticalliance","ai","ai-agent","github-actions","github-marketplace","open-source"],"created_at":"2025-06-22T03:05:59.406Z","updated_at":"2025-08-25T19:07:57.014Z","avatar_url":"https://github.com/Algenix-Org.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 AI Agent Action\n\n[![GitHub release (latest Agent SDK)](https://img.shields.io/github/v/release/nhedger/agent-sdk?label=latest\u0026logo=github\u0026labelColor=374151\u0026color=60a5fa)](https://github.com/marketplace/actions/ai-agent-action)\n[![AI Agent Workflow](https://github.com/Algenix-Org/agent-sdk/actions/workflows/ai-agent.yml/badge.svg)](https://github.com/Algenix-Org/agent-sdk/actions/workflows/ai-agent.yml)\n\n\nA **GitHub Action** for running AI-powered task automation within your workflows.\n\n* ✅ **Free** for public repositories\n* 💼 **Premium** plan coming for private repositories\n\n---\n\n## ✨ Features\n\n* ⚙️ AI-driven task execution via OpenAI or custom models\n* 🔐 Secure environment variable handling (`OPENAI_API_KEY`, `GITHUB_TOKEN`)\n* 🆓 Free tier for public repositories\n* 🚀 Extensible with custom agents via built-in SDK\n* 🔧 Supports JSON input directly or via file\n* 📈 Ideal for automating repetitive workflows with intelligence\n\n---\n\n## 💰 Pricing\n\n| Plan             | Description                                     | Cost                          |\n| ---------------- | ----------------------------------------------- | ----------------------------- |\n| **Free Tier**    | Unlimited use in public repositories            | **Free**                      |\n| **Premium Tier** | Use in private repositories + advanced features | **\\$5/month** *(Coming Soon)* |\n\n\u003e 💡 *Premium version will be available on GitHub Marketplace.*\n\n---\n\n## 🔧 Installation\n\nAdd the action to your GitHub Actions workflow (see below).\n\n---\n\n## 🧱 Prerequisites\n\n* A GitHub repository with Actions enabled\n* GitHub Secret: `OPENAI_API_KEY`\n\n---\n\n## 🚀 Usage\n\n### 📂 Example Workflow: `.github/workflows/ai-agent.yml`\n\n```yaml\nname: Run AI Agent\n\non:\n  push:\n    branches:\n      - main\n\njobs:\n  ai-agent:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v3\n\n      - name: Run AI Agent Action\n        uses: your-username/your-repo@v1\n        with:\n          task-input: '{\"input\": \"Hello, AI Agent!\"}'\n          openai-api-key: ${{ secrets.OPENAI_API_KEY }}\n          agent-name: MyAIAgent\n          log-level: DEBUG\n        id: ai-agent\n\n      - name: Print Result\n        run: echo \"Result: ${{ steps.ai-agent.outputs.result }}\"\n```\n\n---\n\n## ⚙️ Configuration\n\n### 🔐 Required Inputs\n\n| Input            | Description                        |\n| ---------------- | ---------------------------------- |\n| `openai-api-key` | Your OpenAI API key (`secrets`)    |\n| `agent-name`     | Unique name for the agent instance |\n\n### 🧩 Optional Inputs\n\n| Input        | Description                                             | Default |\n| ------------ | ------------------------------------------------------- | ------- |\n| `task-input` | JSON-formatted task input                               | `{}`    |\n| `task-file`  | Path to a JSON file containing the task definition      | —       |\n| `log-level`  | Logging verbosity (`DEBUG`, `INFO`, `WARNING`, `ERROR`) | `INFO`  |\n\n---\n\n## 🧠 Extending the SDK\n\nWant to go further?\nBuild custom agents by subclassing `AIAgentSDK` — full source available in this repository.\n\nExample:\n\n```python\nfrom ai_agent_sdk import AIAgentSDK\n\nclass MyCustomAgent(AIAgentSDK):\n    def execute_task(self, task):\n        return {\n            'status': 'success',\n            'result': f\"Custom result for input: {task.get('input')}\"\n        }\n```\n\n---\n\n## 🛍️ GitHub Marketplace\n\n**Coming Soon**\n\n* Free for public repositories\n* \\$5/month per private repo\n\n---\n\n## 🤝 Contributing\n\nBug reports, ideas, or pull requests are welcome!\nSubmit an issue or PR on GitHub.\n\n---\n\n## 📄 License\n\nMIT License\n\n---\n\n## Roadmap\n\n- [ ] Deploy on Web\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falgenix-org%2Fagent-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falgenix-org%2Fagent-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falgenix-org%2Fagent-sdk/lists"}