{"id":31589385,"url":"https://github.com/robutlerai/webagents","last_synced_at":"2026-04-19T18:03:28.703Z","repository":{"id":312769099,"uuid":"1047975008","full_name":"robutlerai/webagents","owner":"robutlerai","description":"Build, Serve and Monetize AI Agents","archived":false,"fork":false,"pushed_at":"2025-09-30T03:04:59.000Z","size":1979,"stargazers_count":11,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-09-30T05:19:42.299Z","etag":null,"topics":["agents","ai","authentication","discovery","internetofagents","payments","webofagents"],"latest_commit_sha":null,"homepage":"https://robutler.ai/webagents","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/robutlerai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-31T16:39:41.000Z","updated_at":"2025-09-30T03:05:02.000Z","dependencies_parsed_at":"2025-09-30T05:02:41.856Z","dependency_job_id":"2b97a6d4-71f2-4ee8-b405-6cc64d01d4bc","html_url":"https://github.com/robutlerai/webagents","commit_stats":null,"previous_names":["robutlerai/webagents"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/robutlerai/webagents","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robutlerai%2Fwebagents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robutlerai%2Fwebagents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robutlerai%2Fwebagents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robutlerai%2Fwebagents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robutlerai","download_url":"https://codeload.github.com/robutlerai/webagents/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robutlerai%2Fwebagents/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278551493,"owners_count":26005388,"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-10-06T02:00:05.630Z","response_time":65,"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":["agents","ai","authentication","discovery","internetofagents","payments","webofagents"],"created_at":"2025-10-06T02:52:21.363Z","updated_at":"2026-04-19T18:03:28.690Z","avatar_url":"https://github.com/robutlerai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WebAgents - core framework for the Web of Agents\n\n**Build, Serve and Monetize AI Agents**\n\nWebAgents is a powerful opensource framework for building connected AI agents with a simple yet comprehensive API. Put your AI agent directly in front of people who want to use it, with built-in discovery, authentication, and monetization.\n\n[![PyPI version](https://badge.fury.io/py/webagents.svg)](https://badge.fury.io/py/webagents)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n\n## 🚀 Key Features\n\n- **🧩 Modular Skills System** - Combine tools, prompts, hooks, and HTTP endpoints into reusable packages\n- **🤝 Agent-to-Agent Delegation** - Delegate tasks to other agents via natural language. Powered by real-time discovery, authentication, and micropayments for safe, accountable, pay-per-use collaboration across the Web of Agents.\n- **🔍 Real-Time Discovery** - Agents discover each other through intent matching - no manual integration\n- **💰 Built-in Monetization** - Earn credits from priced tools with automatic billing\n- **🔐 Trust \u0026 Security** - Secure authentication and scope-based access control\n- **🌐 Protocol agnostic connectivity** - Deploy agents as standard chat completion endpoints with coming support for OpenAI Responses/Realtime, ACP, A2A and other common AI communication protocols and frameworks.\n- **🔌 Build or Integrate** - Build from scratch with WebAgents, or integrate existing agents from popular SDKs and platforms into the Web of Agents (e.g., Azure AI Foundry, Google Vertex AI, CrewAI, n8n, Zapier).\n\nWith WebAgents delegation, your agent is as powerful as the whole ecosystem, and capabilities of your agent grow together with the whole ecosystem.\n\n## 📦 Installation\n\n```bash\npip install webagents\n```\n\nWebAgents includes everything you need: core framework, LLM integration, and ecosystem skills (MongoDB, Supabase, PostgreSQL, CrewAI, X.com, etc.)\n\n## 🏃‍♂️ Quick Start\n\n### Create Your First Agent\n\n```python\nfrom webagents import BaseAgent\n\n# Create a basic agent\nagent = BaseAgent(\n    name=\"assistant\",\n    instructions=\"You are a helpful AI assistant.\",\n    model=\"litellm/gpt-4o-mini\"  # Automatically creates LLM skill\n)\n\n# Run chat completion\nmessages = [{\"role\": \"user\", \"content\": \"Hello! What can you help me with?\"}]\nresponse = await agent.run(messages=messages)\nprint(response.content)\n```\n\n### Serve Your Agent\n\nDeploy your agent as an OpenAI-compatible API server:\n\n```python\nfrom webagents.server.core.app import create_server\nimport uvicorn\n\n# Create server with your agent\nserver = create_server(agents=[agent])\n\n# Run the server\nuvicorn.run(server.app, host=\"0.0.0.0\", port=8000)\n```\n\nTest your agent API:\n```bash\ncurl -X POST http://localhost:8000/assistant/chat/completions \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"messages\": [{\"role\": \"user\", \"content\": \"Hello!\"}]}'\n```\n\n## 🧩 Skills Framework\n\nSkills combine tools, prompts, hooks, and HTTP endpoints into easy-to-integrate packages:\n\n```python\nfrom webagents.agents.skills.base import Skill\nfrom webagents.agents.tools.decorators import tool, prompt, hook, http\nfrom webagents.agents.skills.robutler.payments.skill import pricing\n\nclass NotificationsSkill(Skill):        \n    @prompt(scope=[\"owner\"])\n    def get_prompt(self) -\u003e str:\n        return \"You can send notifications using send_notification().\"\n    \n    @tool(scope=\"owner\")\n    @pricing(credits_per_call=0.01)\n    async def send_notification(self, title: str, body: str) -\u003e str:\n        # Your API integration\n        return f\"✅ Notification sent: {title}\"\n    \n    @hook(\"on_message\")\n    async def log_messages(self, context):\n        # React to incoming messages\n        return context\n    \n    @http(\"/webhook\", method=\"post\")\n    async def handle_webhook(self, request):\n        # Custom HTTP endpoint\n        return {\"status\": \"received\"}\n```\n\n**Core Skills** - Essential functionality:\n- **LLM Skills**: OpenAI, Anthropic, LiteLLM integration\n- **Memory Skills**: Short-term, long-term, and vector memory\n- **MCP Skill**: Model Context Protocol integration\n\n**Platform Skills** - WebAgents ecosystem:\n- **Discovery**: Real-time agent discovery and routing\n- **Authentication**: Secure agent-to-agent communication  \n- **Payments**: Monetization and automatic billing\n- **Storage**: Persistent data and messaging\n\n**Ecosystem Skills** - External integrations:\n- **Google**: Calendar, Drive, Gmail integration\n- **Database**: SQL and NoSQL database access\n- **Workflow**: CrewAI, N8N, Zapier automation\n\n## 💰 Monetization\n\nAdd payments to earn credits from your agent:\n\n```python\nfrom webagents.agents.core.base_agent import BaseAgent\nfrom webagents.agents.skills.robutler.payments.skill import PaymentSkill, pricing\nfrom webagents.agents.tools.decorators import tool\n\n# Define a priced tool (fixed pricing)\n@tool\n@pricing(credits_per_call=0.01, reason=\"Image generation\")\ndef generate_thumbnail(url: str, size: int = 256) -\u003e dict:\n    \"\"\"Create a thumbnail for a public image URL.\"\"\"\n    # ... your processing logic here ...\n    return {\"url\": url, \"thumbnail_size\": size, \"status\": \"created\"}\n\n\nagent = BaseAgent(\n    name=\"thumbnail-generator\",\n    model=\"litellm/gpt-4o-mini\",\n    skills={\n        \"payments\": PaymentSkill(),\n    },\n    # Auto-register priced tool as capability\n    capabilities=[generate_thumbnail],\n)\n```\n\n## 🔧 Environment Setup\n\nSet up your API keys for LLM providers:\n\n```bash\nexport OPENAI_API_KEY=\"your-openai-key\"\n\n# Robutler API key for payments\nexport WEBAGENTS_API_KEY=\"your-webagents-key\"\n```\n\nGet your WEBAGENTS_API_KEY at https://robutler.ai/developer\n\n\n## 🌐 Web of Agents\n\nWebAgents enables dynamic real-time orchestration where each AI agent acts as a building block for other agents:\n\n- **🚀 Real-Time Discovery**: Think DNS for agent intents - agents find each other through natural language\n- **🔐 Trust \u0026 Security**: Secure authentication with audit trails for all transactions\n- **💡 Delegation by Design**: Seamless delegation across agents, enabled by real-time discovery, scoped authentication, and micropayments. No custom integrations or API keys to juggle—describe the need, and the right agent is invoked on demand.\n\n## 📚 Documentation\n\n- **[Full Documentation](https://robutler.ai/docs/webagents)** - Complete guides and API reference\n- **[Skills Framework](https://robutler.ai/docs/webagents/skills/overview/)** - Deep dive into modular capabilities\n- **[Agent Architecture](https://robutler.ai/docs/webagents/agent/overview/)** - Understand agent communication\n- **[Custom Skills](https://robutler.ai/docs/webagents/skills/custom/)** - Build your own capabilities\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](https://robutler.ai/docs/webagents/developers/contributing/) for details.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🆘 Support\n\n- **GitHub Issues**: [Report bugs and request features](https://github.com/robutlerai/webagents/issues)\n- **Documentation**: [robutler.ai/docs/webagents](https://robutler.ai/docs/webagents)\n- **Community**: Join our Discord server for discussions and support\n\n---\n\n**Focus on what makes your agent unique instead of spending time on plumbing.**\n\nBuilt with ❤️ by the [WebAgents team](https://robutler.ai) and community contributors.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobutlerai%2Fwebagents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobutlerai%2Fwebagents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobutlerai%2Fwebagents/lists"}