Turn any GitHub repo into an AI agent in one command
Project description
AgentEazy
Turn any GitHub repo into an interoperable AI agent in one command.
Open source · MIT Licensed · agenteazy.com
Quick Start
pip install agenteazy
agenteazy signup <your-github-username>
agenteazy deploy github.com/you/your-repo
Your repo is now a live agent. Call it:
curl -X POST https://simondusable--agenteazy-gateway-serve.modal.run/agent/your-repo/ \
-H "Content-Type: application/json" \
-d '{"verb":"DO","payload":{"data":{"input":"hello"}}}'
Python SDK
pip install agenteazy
from agenteazy import AgentEazy
client = AgentEazy()
# Search for agents
agents = client.find("password strength")
# Call an agent
result = client.do("zxcvbn-python", {"password": "test123"})
print(result)
LangChain Integration
pip install agenteazy[langchain]
from agenteazy.integrations.langchain import AgentEazyTool, AgentEazyToolkit
# Single tool from one agent
tool = AgentEazyTool.from_agent("zxcvbn-python")
result = tool.run({"password": "test123"})
# Toolkit — multiple tools from a registry search
toolkit = AgentEazyToolkit()
tools = toolkit.get_tools(query="text processing", limit=5)
CrewAI Integration
pip install agenteazy[crewai]
from agenteazy.integrations.crewai import AgentEazyCrewTool
tool = AgentEazyCrewTool.from_agent("zxcvbn-python")
result = tool.run({"password": "test123"})
CLI Commands
Core
| Command | Description |
|---|---|
agenteazy analyze <repo> |
Detect language, deps, entry point |
agenteazy wrap <repo> |
Generate agent.json + FastAPI wrapper |
agenteazy wrap <repo> --entry func |
Specify entry function |
agenteazy wrap <repo> --env KEY=VAL |
Set environment variables |
agenteazy deploy <repo> |
Deploy to gateway + register |
agenteazy deploy <repo> --local |
Test locally on port 8000 |
agenteazy deploy <repo> --price 10 |
Deploy as paid agent (10 credits/call) |
Batch
| Command | Description |
|---|---|
agenteazy batch-analyze <dir> |
Analyze all repos in a directory |
agenteazy batch-deploy <dir> |
Deploy multiple repos at once |
agenteazy batch-deploy <dir> --wrap-only |
Wrap without deploying |
agenteazy batch-deploy <dir> --dry-run |
Preview without changes |
agenteazy batch-deploy <dir> --entry-file main.py |
Override entry file |
agenteazy batch-deploy <dir> --skip-existing |
Skip already-deployed agents |
agenteazy batch-deploy <dir> --max-failures 3 |
Stop after N failures |
Account
| Command | Description |
|---|---|
agenteazy signup <username> |
Create account, get API key |
agenteazy balance |
Check credit balance |
agenteazy transactions |
View transaction history |
Registry
| Command | Description |
|---|---|
agenteazy search "query" |
Search agent registry |
agenteazy list |
List all registered agents |
agenteazy status |
Show deployment status |
Environment Variables
| Command | Description |
|---|---|
agenteazy env list |
List configured env vars |
agenteazy env set KEY VAL |
Set an environment variable |
agenteazy env remove KEY |
Remove an environment variable |
Infrastructure
| Command | Description |
|---|---|
agenteazy gateway deploy |
Deploy gateway to Modal |
agenteazy gateway status |
Gateway health check |
agenteazy registry deploy |
Deploy registry to Modal |
agenteazy registry start |
Run registry locally |
agenteazy stop <name> |
Stop a deployed agent |
agenteazy logs <name> |
View agent logs |
AgentLang — 10 Universal Verbs
Every agent speaks the same protocol. One HTTP POST, one envelope:
{"verb": "DO", "payload": {"data": {"input": "hello"}}}
| Verb | Purpose | Status |
|---|---|---|
| DO | Execute a task | Working ✅ |
| ASK | Query capabilities | Working ✅ |
| FIND | Search the registry | Working ✅ |
| PAY | Transfer credits between agents | Working ✅ |
| SHARE | Pass context to an agent | Working ✅ |
| REPORT | Get audit log and recent calls | Working ✅ |
| STOP | Halt a running task | Working ✅ |
| WATCH | Subscribe to events | Stub 🔜 |
| TRUST | Establish authenticated session | Stub 🔜 |
| LEARN | Ingest new knowledge | Stub 🔜 |
TollBooth — Agent Credits
Agents can charge credits per call. Developers earn 80%, platform keeps 20% for infrastructure.
agenteazy deploy github.com/you/ml-model --price 10
No billing code needed. Set a price and the gateway handles everything.
- Free agents: 0 credits per call (default)
- Paid agents: Set any price with
--price - Revenue split: 80% to agent developer, 20% platform fee
- Top up:
agenteazy balanceto check, credits added via signup
Architecture
Developer: agenteazy deploy <repo>
|
|-- 1. ANALYZE -> Clone, detect Python, parse AST
|-- 2. WRAP -> Generate agent.json + FastAPI wrapper
|-- 3. UPLOAD -> Push to serverless volume
|-- 4. REGISTER -> Add to public registry
+-- 5. LIVE -> Callable at gateway/agent/{name}/
Gateway (1 endpoint) ---- Registry (SQLite)
| |
+-- Agent Volume +-- TollBooth (credits)
/agents/repo-a/ /tollbooth/balance
/agents/repo-b/ /tollbooth/deduct
/agents/repo-c/ /tollbooth/earn
Supported Repo Types
| Type | Supported |
|---|---|
requirements.txt |
✅ |
pyproject.toml |
✅ |
setup.py |
✅ |
| Class-based agents | ✅ |
src/ layout |
✅ |
| Environment variables | ✅ |
Contributing
We welcome contributions:
- Open an issue describing what you want to build or fix
- We'll discuss the approach together
- Clone the repo and create a feature branch
- Submit a Pull Request referencing the issue
Questions? Open an issue or email hello@agenteazy.com
License
MIT — see LICENSE for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agenteazy-0.2.0.tar.gz.
File metadata
- Download URL: agenteazy-0.2.0.tar.gz
- Upload date:
- Size: 521.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ddeae91a2e113f1570665da00037d34a5d078f4c98aab2015f391ec6ff2920b3
|
|
| MD5 |
b7aa731a17a9ee64518034740beda22b
|
|
| BLAKE2b-256 |
7f1e0e1a55d8cca780c3b9323462571edb1c9ec477709bba66ee07d4e16f1af3
|
File details
Details for the file agenteazy-0.2.0-py3-none-any.whl.
File metadata
- Download URL: agenteazy-0.2.0-py3-none-any.whl
- Upload date:
- Size: 611.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cdd579f6f4c13cc3345c1a0f89557f838c05e65800fbc3f6d8d4b12b738263cd
|
|
| MD5 |
3adcec0bb4ac8a879228cf9df59d5eab
|
|
| BLAKE2b-256 |
4ac270b4f78c1445bce8186e8028d5ed93fde09bdba095dcf3c0abda088cf0a7
|