{"id":23933597,"url":"https://github.com/The-Swarm-Corporation/AgentOS","last_synced_at":"2025-09-11T16:32:14.847Z","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":"2024-12-13T20:46:18.000Z","size":15,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-13T21:25:19.610Z","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":"2024-12-13T20:46:22.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":232658685,"owners_count":18556988,"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-01-06T00:29:48.003Z","updated_at":"2025-09-11T16:32:14.802Z","avatar_url":"https://github.com/The-Swarm-Corporation.png","language":"Python","funding_links":["https://github.com/sponsors/kyegomez"],"categories":["Building","🛠️ Development Tools \u0026 Platforms"],"sub_categories":["Security","Core Platforms \u0026 Operating Systems"],"readme":"# AgentOS\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n\nA minimal, production-ready implementation of Andrej Karpathy's Agent Operating System architecture, developed by Swarms.ai and partners.\n\n![AgentOS Architecture](https://miro.medium.com/v2/resize:fit:748/1*quuHoEjoCzxvu5lVp_SMEQ@2x.jpeg)\n\n## Overview\n\nAgentOS is a lightweight, single-file implementation that provides a robust foundation for building autonomous AI agents. It implements the core concepts outlined in Karpathy's Agent OS architecture while maintaining simplicity and extensibility. Developed by [Swarms.ai](https://swarms.ai) and its partners, AgentOS is a production-ready implementation of autonomous AI agents that follows the architectural principles outlined by Andrej Karpathy.\n\n\n## Features\n\n- **Unified Model Interface**: Seamless integration with multiple LLM providers through LiteLLM\n  - Support for Anthropic Claude models (Opus, Sonnet, Haiku)\n  - Integration with OpenAI GPT models\n  - Access to optimized variants (GPT-4o, GPT-4o-mini)\n- **Browser Automation**: Built-in browser agent capabilities for web interaction using browser-use\n- **Multi-Modal Support**: \n  - Text processing and generation\n  - Video analysis through Google's Gemini models\n  - Audio processing and speech synthesis\n  - Image handling capabilities\n- **Resource Management**: \n  - Efficient handling of computational resources\n  - Dynamic model selection based on task requirements\n  - Automatic GPU/CPU optimization\n- **HuggingFace Integration**: \n  - Direct access to open-source models\n  - Support for text generation and multiple NLP tasks\n  - Automatic model quantization and optimization\n- **Extensible Architecture**: Easy to add new capabilities and tools\n\n## Core Components\n\n- **Model Management**: Dynamic selection and utilization of language models\n- **Browser Automation**: Autonomous web-based task execution\n- **Resource Orchestration**: Efficient management of computational resources\n- **Context Management**: Maintains system state and task dependencies\n\n## Installation\n\n```bash\npip3 install -U agentos-sdk\n```\n\n## Usage\n\n```python\nfrom agentos_sdk import AgentOS\nfrom dotenv import load_dotenv\n\nload_dotenv()\n\nagent = AgentOS(plan_on=False, max_loops=1)\n\nagent.run(\n    \"Generate a video of a cat surfing on a wave at sunset, cinematic style. Save it as 'cat_surfing.mp4. We should also add cat sounds and meowing sounds.\"\n)\n\n```\n\n## Available Tools\n\nAgentOS comes with a powerful set of built-in tools that enable various capabilities. Here's a comprehensive list of all available tools:\n\n| Tool Name | Description | Use Case Examples |\n|-----------|-------------|------------------|\n| Browser Agent | Autonomous web browser automation tool that can navigate websites, extract information, and perform web-based tasks | - Web scraping\u003cbr\u003e- Form filling\u003cbr\u003e- Data extraction\u003cbr\u003e- Website testing |\n| Hugging Face Model | Interface for using various Hugging Face models for text generation and other NLP tasks | - Text generation\u003cbr\u003e- Language translation\u003cbr\u003e- Text classification\u003cbr\u003e- Custom model inference |\n| LiteLLM Model | Unified interface for multiple LLM providers including OpenAI, Anthropic, and others | - Text generation\u003cbr\u003e- Chat completion\u003cbr\u003e- Content creation\u003cbr\u003e- Advanced reasoning |\n| Safe Calculator | Secure mathematical expression evaluator with built-in safety checks | - Mathematical calculations\u003cbr\u003e- Formula evaluation\u003cbr\u003e- Secure computation\u003cbr\u003e- Numeric processing |\n| Terminal Developer Agent | Advanced agent for performing terminal operations and development tasks | - File operations\u003cbr\u003e- Code execution\u003cbr\u003e- System commands\u003cbr\u003e- Development tasks |\n| Generate Speech | Text-to-speech conversion tool supporting multiple voices and models | - Audio content creation\u003cbr\u003e- Voice synthesis\u003cbr\u003e- Accessibility features\u003cbr\u003e- Audio narration |\n| Generate Video | AI-powered video generation tool using Google's Veo 3.0 model | - Video content creation\u003cbr\u003e- Visual storytelling\u003cbr\u003e- Animation generation\u003cbr\u003e- Creative content |\n| Create Files | Tool for creating new files in the workspace with specified content | - Document creation\u003cbr\u003e- Code file generation\u003cbr\u003e- Report writing\u003cbr\u003e- Configuration files |\n| Update Files | Tool for updating existing files by overwriting their content | - Content modification\u003cbr\u003e- File updates\u003cbr\u003e- Document revisions\u003cbr\u003e- Configuration changes |\n\n\n## Community \n\nJoin our community of agent engineers and researchers for technical support, cutting-edge updates, and exclusive access to world-class agent engineering insights!\n\n| Platform | Description | Link |\n|----------|-------------|------|\n| 📚 Documentation | Official documentation and guides | [docs.swarms.world](https://docs.swarms.world) |\n| 📝 Blog | Latest updates and technical articles | [Medium](https://medium.com/@kyeg) |\n| 💬 Discord | Live chat and community support | [Join Discord](https://discord.gg/jM3Z6M9uMq) |\n| 🐦 Twitter | Latest news and announcements | [@kyegomez](https://twitter.com/swarms_corp) |\n| 👥 LinkedIn | Professional network and updates | [The Swarm Corporation](https://www.linkedin.com/company/the-swarm-corporation) |\n| 📺 YouTube | Tutorials and demos | [Swarms Channel](https://www.youtube.com/channel/UC9yXyitkbU_WSy7bd_41SqQ) |\n| 🎫 Events | Join our community events | [Sign up here](https://lu.ma/5p2jnc2v) |\n| 🚀 Onboarding Session | Get onboarded with Kye Gomez, creator and lead maintainer of Swarms | [Book Session](https://cal.com/swarms/swarms-onboarding-session) |\n\n## Contributing\n\nWe welcome contributions from the community. Please see our contributing guidelines for more information. \n\n## License\n\nThis project is under the MIT License.\n\n## Todo\n\n- [ ] Add deep research agent or sub agent\n- [ ] Implement video and audio processing\n- [ ] Create better system prompt and add multiple shot examples on when to use certain tools and etc ","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"}