{"id":26249809,"url":"https://github.com/the-swarm-corporation/agentos","last_synced_at":"2025-04-24T02:07:35.267Z","repository":{"id":268021805,"uuid":"903017750","full_name":"The-Swarm-Corporation/AgentOS","owner":"The-Swarm-Corporation","description":"AgentOS implements a comprehensive security architecture leveraging containerization, orchestration, and multi-layer isolation to ensure secure execution of autonomous agents. ","archived":false,"fork":false,"pushed_at":"2025-01-20T02:25:35.000Z","size":40,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-24T02:07:29.717Z","etag":null,"topics":["agentos","agents","ai","ml","multi-agent","operating-system","swarms"],"latest_commit_sha":null,"homepage":"https://swarms.xyz/","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/The-Swarm-Corporation.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["kyegomez"]}},"created_at":"2024-12-13T18:48:24.000Z","updated_at":"2025-02-21T15:59:56.000Z","dependencies_parsed_at":"2024-12-13T21:36:59.953Z","dependency_job_id":null,"html_url":"https://github.com/The-Swarm-Corporation/AgentOS","commit_stats":null,"previous_names":["the-swarm-corporation/agentos"],"tags_count":0,"template":false,"template_full_name":"The-Swarm-Corporation/Swarms-Example-1-Click-Template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Swarm-Corporation%2FAgentOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Swarm-Corporation%2FAgentOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Swarm-Corporation%2FAgentOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Swarm-Corporation%2FAgentOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/The-Swarm-Corporation","download_url":"https://codeload.github.com/The-Swarm-Corporation/AgentOS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250546080,"owners_count":21448260,"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","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":["agentos","agents","ai","ml","multi-agent","operating-system","swarms"],"created_at":"2025-03-13T15:49:52.479Z","updated_at":"2025-04-24T02:07:35.233Z","avatar_url":"https://github.com/The-Swarm-Corporation.png","language":"Python","funding_links":["https://github.com/sponsors/kyegomez"],"categories":[],"sub_categories":[],"readme":"\n# AgentOS: Enterprise-Grade Agent Infrastructure Platform\n\n\n[![Join our Discord](https://img.shields.io/badge/Discord-Join%20our%20server-5865F2?style=for-the-badge\u0026logo=discord\u0026logoColor=white)](https://discord.gg/agora-999382051935506503) [![Subscribe on YouTube](https://img.shields.io/badge/YouTube-Subscribe-red?style=for-the-badge\u0026logo=youtube\u0026logoColor=white)](https://www.youtube.com/@kyegomez3242) [![Connect on LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue?style=for-the-badge\u0026logo=linkedin\u0026logoColor=white)](https://www.linkedin.com/in/kye-g-38759a207/) [![Follow on X.com](https://img.shields.io/badge/X.com-Follow-1DA1F2?style=for-the-badge\u0026logo=x\u0026logoColor=white)](https://x.com/kyegomezb)\n\n\n[![GitHub stars](https://img.shields.io/github/stars/The-Swarm-Corporation/Legal-Swarm-Template?style=social)](https://github.com/The-Swarm-Corporation/Legal-Swarm-Template)\n[![Swarms Framework](https://img.shields.io/badge/Built%20with-Swarms-blue)](https://github.com/kyegomez/swarms)\n\n\n[![GitHub stars](https://img.shields.io/github/stars/The-Swarm-Corporation/agentos?style=social)](https://github.com/The-Swarm-Corporation/agentos)\n[![PyPI version](https://badge.fury.io/py/agentos.svg)](https://badge.fury.io/py/agentos)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Documentation Status](https://readthedocs.org/projects/agentos/badge/?version=latest)](https://agentos.readthedocs.io/en/latest/?badge=latest)\n\nAgentOS is an enterprise-ready infrastructure platform designed for deploying, managing, and scaling AI agents in production environments. It provides secure sandboxed environments, robust monitoring, and scalable architecture for reliable agent operations.\n\n## 🚀 Key Features\n\n- Secure containerized environment\n- Integrated memory system\n- Tool access management\n- API endpoints for agent interaction\n- Horizontal scaling support\n- Production-grade security\n\n## Prerequisites\n- Docker 24.0+\n- Docker Compose 2.0+\n- Kubernetes 1.25+ (for orchestration)\n\n## Environment Variables\nCreate a `.env` file with the following required variables:\n\n```env\n# Core Configuration\nWORKSPACE_DIR=agent_workspace\n\n# API Keys\nOPENAI_API_KEY=your_openai_key\nANTHROPIC_API_KEY=your_anthropic_key\nPINECONE_API_KEY=your_pinecone_key\nGOOGLE_API_KEY=your_google_key\nREPLICATE_API_TOKEN=your_replicate_token\nSTABILITY_API_KEY=your_stability_key\nCOHERE_API_KEY=your_cohere_key\n\n# Optional Configuration\nWORKERS=4\nTIMEOUT=120\nLOG_LEVEL=warning\nMAX_REQUESTS=10000\n```\n\n## Quick Start\n\n### Using Docker\n\n1. Build the image:\n```bash\ndocker build -t agent-api:latest .\n```\n\n2. Run the container:\n```bash\ndocker run -d \\\n    --name agent-api \\\n    --env-file .env \\\n    -p 8000:8000 \\\n    -v $(pwd)/data:/agent_workspace/data \\\n    -v $(pwd)/logs:/agent_workspace/logs \\\n    --security-opt=no-new-privileges \\\n    --cap-drop=ALL \\\n    --read-only \\\n    agent-api:latest\n```\n\n### Using Docker Compose\n\n1. Start the services:\n```bash\ndocker compose up -d\n```\n\n2. View logs:\n```bash\ndocker compose logs -f\n```\n\n3. Stop services:\n```bash\ndocker compose down\n```\n\n## Kubernetes Deployment\n\n1. Create required namespaces and secrets:\n```bash\n# Apply the complete configuration\nkubectl apply -f complete-agent-deployment.yaml\n\n# Verify the deployment\nkubectl get all -n agent-system\n```\n\n2. Monitor the deployment:\n```bash\nkubectl get pods -n agent-system\nkubectl describe deployment agent-api -n agent-system\n```\n\n## Security Configuration\n\n### Docker Security Features\n- Non-root user execution\n- Read-only filesystem\n- Dropped capabilities\n- No privilege escalation\n- Resource limitations\n- Health checks\n\n### Kubernetes Security Features\n- Network policies\n- Resource quotas\n- Security contexts\n- Service accounts\n- Secret management\n\n## Directory Structure\n```\n/\n├── Dockerfile\n├── docker-compose.yml\n├── complete-agent-deployment.yaml\n├── .env\n├── data/\n└── logs/\n└── agent_api/\n    └── main.py\n```\n\n## Monitoring\n\n### Docker\n```bash\n# Container stats\ndocker stats agent-api\n\n# Container logs\ndocker logs -f agent-api\n\n# Container health\ndocker inspect agent-api\n```\n\n### Kubernetes\n```bash\n# Pod metrics\nkubectl top pods -n agent-system\n\n# Pod logs\nkubectl logs -f deployment/agent-api -n agent-system\n\n# Deployment status\nkubectl get deployment agent-api -n agent-system -o wide\n```\n\n## Production Deployment Checklist\n\n1. Environment Configuration\n   - [ ] Set all required API keys\n   - [ ] Configure resource limits\n   - [ ] Set appropriate log levels\n\n2. Security\n   - [ ] Enable security features\n   - [ ] Configure network policies\n   - [ ] Set up secret management\n\n3. Storage\n   - [ ] Configure persistent volumes\n   - [ ] Set up backup solutions\n   - [ ] Configure log rotation\n\n4. Monitoring\n   - [ ] Set up health checks\n   - [ ] Configure logging\n   - [ ] Set up metrics collection\n\n## API Endpoints\n\nThe service exposes the following endpoint:\n- `http://localhost:8000/health` - Health check endpoint\n\n## Troubleshooting\n\n### Common Issues\n\n1. Container fails to start:\n```bash\n# Check container logs\ndocker logs agent-api\n\n# Check container status\ndocker inspect agent-api\n```\n\n2. Permission issues:\n```bash\n# Ensure volumes have correct permissions\nchmod -R 770 data logs\n```\n\n3. Resource constraints:\n```bash\n# Check resource usage\ndocker stats agent-api\n```\n\n## Support\n\nFor issues and feature requests, please open an issue in the repository.\n\n## License\n\n[MIT License](LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthe-swarm-corporation%2Fagentos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthe-swarm-corporation%2Fagentos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthe-swarm-corporation%2Fagentos/lists"}