Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/The-Swarm-Corporation/AgentOS
AgentOS implements a comprehensive security architecture leveraging containerization, orchestration, and multi-layer isolation to ensure secure execution of autonomous agents.
https://github.com/The-Swarm-Corporation/AgentOS
agentos agents ai ml multi-agent operating-system swarms
Last synced: 3 days ago
JSON representation
AgentOS implements a comprehensive security architecture leveraging containerization, orchestration, and multi-layer isolation to ensure secure execution of autonomous agents.
- Host: GitHub
- URL: https://github.com/The-Swarm-Corporation/AgentOS
- Owner: The-Swarm-Corporation
- License: mit
- Created: 2024-12-13T18:48:24.000Z (26 days ago)
- Default Branch: main
- Last Pushed: 2024-12-13T20:46:18.000Z (26 days ago)
- Last Synced: 2024-12-13T21:25:19.610Z (26 days ago)
- Topics: agentos, agents, ai, ml, multi-agent, operating-system, swarms
- Language: Python
- Homepage: https://swarms.xyz/
- Size: 14.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome_ai_agents - Agentos - AgentOS implements a comprehensive security architecture leveraging containerization, orchestration, and multi-layer isolation to ensure … (Building / Security)
- awesome_ai_agents - Agentos - AgentOS implements a comprehensive security architecture leveraging containerization, orchestration, and multi-layer isolation to ensure … (Building / Security)
README
# AgentOS: Enterprise-Grade Agent Infrastructure Platform
[](https://discord.gg/agora-999382051935506503) [](https://www.youtube.com/@kyegomez3242) [](https://www.linkedin.com/in/kye-g-38759a207/) [](https://x.com/kyegomezb)
[](https://github.com/The-Swarm-Corporation/Legal-Swarm-Template)
[](https://github.com/kyegomez/swarms)
[](https://github.com/The-Swarm-Corporation/agentos)
[](https://badge.fury.io/py/agentos)
[](https://opensource.org/licenses/Apache-2.0)
[](https://agentos.readthedocs.io/en/latest/?badge=latest)
AgentOS 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.
## 🚀 Key Features
- Secure containerized environment
- Integrated memory system
- Tool access management
- API endpoints for agent interaction
- Horizontal scaling support
- Production-grade security
## Prerequisites
- Docker 24.0+
- Docker Compose 2.0+
- Kubernetes 1.25+ (for orchestration)
## Environment Variables
Create a `.env` file with the following required variables:
```env
# Core Configuration
WORKSPACE_DIR=agent_workspace
# API Keys
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
PINECONE_API_KEY=your_pinecone_key
GOOGLE_API_KEY=your_google_key
REPLICATE_API_TOKEN=your_replicate_token
STABILITY_API_KEY=your_stability_key
COHERE_API_KEY=your_cohere_key
# Optional Configuration
WORKERS=4
TIMEOUT=120
LOG_LEVEL=warning
MAX_REQUESTS=10000
```
## Quick Start
### Using Docker
1. Build the image:
```bash
docker build -t agent-api:latest .
```
2. Run the container:
```bash
docker run -d \
--name agent-api \
--env-file .env \
-p 8000:8000 \
-v $(pwd)/data:/agent_workspace/data \
-v $(pwd)/logs:/agent_workspace/logs \
--security-opt=no-new-privileges \
--cap-drop=ALL \
--read-only \
agent-api:latest
```
### Using Docker Compose
1. Start the services:
```bash
docker compose up -d
```
2. View logs:
```bash
docker compose logs -f
```
3. Stop services:
```bash
docker compose down
```
## Kubernetes Deployment
1. Create required namespaces and secrets:
```bash
# Apply the complete configuration
kubectl apply -f complete-agent-deployment.yaml
# Verify the deployment
kubectl get all -n agent-system
```
2. Monitor the deployment:
```bash
kubectl get pods -n agent-system
kubectl describe deployment agent-api -n agent-system
```
## Security Configuration
### Docker Security Features
- Non-root user execution
- Read-only filesystem
- Dropped capabilities
- No privilege escalation
- Resource limitations
- Health checks
### Kubernetes Security Features
- Network policies
- Resource quotas
- Security contexts
- Service accounts
- Secret management
## Directory Structure
```
/
├── Dockerfile
├── docker-compose.yml
├── complete-agent-deployment.yaml
├── .env
├── data/
└── logs/
└── agent_api/
└── main.py
```
## Monitoring
### Docker
```bash
# Container stats
docker stats agent-api
# Container logs
docker logs -f agent-api
# Container health
docker inspect agent-api
```
### Kubernetes
```bash
# Pod metrics
kubectl top pods -n agent-system
# Pod logs
kubectl logs -f deployment/agent-api -n agent-system
# Deployment status
kubectl get deployment agent-api -n agent-system -o wide
```
## Production Deployment Checklist
1. Environment Configuration
- [ ] Set all required API keys
- [ ] Configure resource limits
- [ ] Set appropriate log levels
2. Security
- [ ] Enable security features
- [ ] Configure network policies
- [ ] Set up secret management
3. Storage
- [ ] Configure persistent volumes
- [ ] Set up backup solutions
- [ ] Configure log rotation
4. Monitoring
- [ ] Set up health checks
- [ ] Configure logging
- [ ] Set up metrics collection
## API Endpoints
The service exposes the following endpoint:
- `http://localhost:8000/health` - Health check endpoint
## Troubleshooting
### Common Issues
1. Container fails to start:
```bash
# Check container logs
docker logs agent-api
# Check container status
docker inspect agent-api
```
2. Permission issues:
```bash
# Ensure volumes have correct permissions
chmod -R 770 data logs
```
3. Resource constraints:
```bash
# Check resource usage
docker stats agent-api
```
## Support
For issues and feature requests, please open an issue in the repository.
## License
[MIT License](LICENSE)