Expand description
Β§π€ AutoGPT

π§ Linux (Recommended) | πͺ Windows | π | π |
|---|---|---|---|
![]() | ![]() | - | - |
| Method 1: Download Executable File | Download .exe File | - | - |
Method 2: cargo install autogpt --all-features | cargo install autogpt --all-features | docker pull kevinrsdev/autogpt | docker pull kevinrsdev/orchgpt |
| Set Environment Variables | Set Environment Variables | Set Environment Variables | Set Environment Variables |
autogpt -h orchgpt -h | autogpt.exe -h | docker run kevinrsdev/autogpt -h | docker run kevinrsdev/orchgpt -h |
[!NOTE] This project is under active development. There is also a parallel project, lmm, under equally active development; It does not use LLMs at all. Instead, it uses equation-based intelligence to predict new words and reason without gradient-trained models. Check it out if youβre interested in a fundamentally different approach to machine intelligence!
AutoGPT is a pure rust framework that simplifies AI agent creation and management for various tasks. Its remarkable speed and versatility are complemented by a mesh of built-in interconnected GPTs, ensuring exceptional performance and adaptability.
Β§π§ Framework Overview
AutoGPT agents are modular, autonomous, and designed for flexibility:
- π Tools & Sensors: Interface with the real world via actions (e.g., file I/O, APIs) and perception (e.g., audio, video, data).
- π§ Memory & Knowledge: Combines long-term vector memory with structured knowledge bases for reasoning and recall.
- π No-Code Agent Configs: Define agents and their behaviors with simple, declarative YAML, no coding required.
- π§ Planner & Goals: Breaks down complex tasks into subgoals and tracks progress dynamically.
- π§ Persona & Capabilities: Customizable behavior profiles and access controls define how agents act.
- π§βπ€βπ§ Collaboration: Agents can delegate, swarm, or work in teams with other agents.
- πͺ Self-Reflection: Introspection module to debug, adapt, or evolve internal strategies.
- π Context Management: Manages active memory (context window) for ongoing tasks and conversations.
- π MCP (Model Context Protocol): First-class support to seamlessly connect external tool servers (Stdio, SSE, HTTP) to extend capabilities.
- π Scheduler: Time-based or reactive triggers for agent actions.
- π§ͺ Custom Agent Creation: Build tailored agents for different roles or domains.
- π Task Orchestration: Manage and distribute tasks across agents efficiently.
- π§± Extensibility: Add new tools, behaviors, or agent types with ease.
- π» CLI Tools: Command-line interface for rapid experimentation and control.
- π§° SDK Support: Embed AutoGPT into existing projects or systems seamlessly.
- π Mixture of Providers (MoP): Parallel fan-out and weighted scoring across multiple AI backends for optimal response quality.
Β§π¦ Installation
Please refer to our tutorial for guidance on installing, running, and/or building the CLI from source using either Cargo or Docker.
[!NOTE] For optimal performance and compatibility, we strongly advise utilizing a Linux operating system to install this CLI.
Β§π Workflow
AutoGPT supports 4 modes of operation: interactive, direct prompt, standalone agentic, and distributed agentic.
Β§0. π€ GenericGPT Interactive Mode (Default)
When you run autogpt with no subcommand or flags, it launches an interactive AI TUI powered by GenericGPT, a production-hardened autonomous software engineering agent. GenericGPT features intent detection, a complete seven-step reasoning and execution pipeline, automatic build-and-verify loops, and metacognition for learning across tasks.
autogpt[!NOTE] For an in-depth breakdown of how GenericGPT works under the hood, including its architecture, interactive shell, Mixture of Providers (MoP), and execution pipeline, see the GenericGPT Documentation.
Β§1. π¬ Direct Prompt Mode
In this mode, you can use the CLI to interact with the LLM directly, no need to define or configure agents. Use the -p flag to send prompts to your preferred LLM provider quickly and easily. Combine with --mixture to get the best answer from all your providers at once.
# Single provider
autogpt -p "Explain the Rust borrow checker in simple terms"
# Mixture of Providers (fanned out)
autogpt -m -p "Implement a Red-Black tree in Rust"Β§2. π§ Agentic Networkless Mode (Standalone)
In this mode, the user runs an individual autogpt agent directly via a subcommand (e.g., autogpt arch). Each agent operates independently without needing a networked orchestrator.
flowchart TD
User([User Provides Project Prompt]) --> M[ManagerGPT\nDistributes Tasks]
M --> B[BackendGPT]
M --> F[FrontendGPT]
M --> D[DesignerGPT\nOptional]
M --> A[ArchitectGPT]
B --> BL[Backend Logic]
F --> FL[Frontend Logic]
D --> DL[Design Assets]
A --> AL[Architecture Diagram]
BL & FL & DL & AL --> M2[ManagerGPT\nCollects & Consolidates]
M2 --> Result([User Receives Final Output])- βοΈ User Input: Provide a projectβs goal (e.g. βDevelop a full stack app that fetches todayβs weather. Use the axum web framework for the backend and the Yew rust framework for the frontend.β).
- π Initialization: AutoGPT initializes based on the userβs input, creating essential components such as the
ManagerGPTand individual agent instances (ArchitectGPT, BackendGPT, FrontendGPT). - π οΈ Agent Configuration: Each agent is configured with its unique objectives and capabilities, aligning them with the projectβs defined goals.
- π Task Allocation: ManagerGPT distributes tasks among agents considering their capabilities and project requirements.
- βοΈ Task Execution: Agents execute tasks asynchronously, leveraging their specialized functionalities.
- π Feedback Loop: Continuous feedback updates users on project progress and addresses issues.
Β§3. π Agentic Networking Mode (Orchestrated)
In networking mode, autogpt connects to an external orchestrator (orchgpt) over a secure TLS-encrypted TCP channel. This orchestrator manages agent lifecycles, routes commands, and enables rich inter-agent collaboration using a unified protocol.
AutoGPT introduces a novel and scalable communication protocol called IAC (Inter/Intra-Agent Communication), enabling seamless and secure interactions between agents and orchestrators, inspired by operating system IPC mechanisms.
flowchart TD
U([User sends prompt via CLI]) -- TLS + Protobuf over TCP --> O[Orchestrator\nReceives & Routes Commands]
O --> AG[ArchitectGPT]
O --> MG[ManagerGPT]
AG <-- IAC --> MG
subgraph IAC [" IAC - Inter/Intra-Agent Communication Layer"]
MG
BG[BackendGPT]
FG[FrontendGPT]
DG[DesignerGPT]
end
MG -- IAC --> BG
MG -- IAC --> FG
MG -- IAC --> DG
BG & FG & DG --> Exec[Task Execution & Collection]
Exec --> R([User Receives Final Output])All communication happens securely over TLS + TCP, with messages encoded in Protocol Buffers (protobuf) for efficiency and structure.
-
User Input: The user provides a project prompt like:
/arch create "fastapi app" | pythonThis is securely sent to the Orchestrator over TLS.
-
Initialization: The Orchestrator parses the command and initializes the appropriate agent (e.g.,
ArchitectGPT). -
Agent Configuration: Each agent is instantiated with its specialized goals:
- ArchitectGPT: Plans system structure
- BackendGPT: Generates backend logic
- FrontendGPT: Builds frontend UI
- DesignerGPT: Handles design
-
Task Allocation:
ManagerGPTdynamically assigns subtasks to agents using the IAC protocol. It determines which agent should perform what based on capabilities and the original user goal. -
Task Execution: Agents execute their tasks, communicate with their subprocesses or other agents via IAC (inter/intra communication), and push updates or results back to the orchestrator.
-
Feedback Loop: Throughout execution, agents return status reports. The
ManagerGPTcollects all output, and the Orchestrator sends it back to the user.
Β§π€ Available Agents
At the current release, AutoGPT consists of 9 built-in specialized autonomous AI agents ready to assist you in bringing your ideas to life! Refer to our guide to learn more about how the built-in agents work.
Β§π Examples
Your can refer to our examples for guidance on how to use the cli in a jupyter environment.
Β§π Documentation
For detailed usage instructions and API documentation, refer to the AutoGPT Documentation.
Β§π€ Contributing
Contributions are welcome! See the Contribution Guidelines for more information on how to get started.
Β§π License
This project is licensed under the MIT License - see the LICENSE file for details.
ModulesΒ§
- agents
- Agents module.
- cli
cli - collaboration
net - common
- Common module.
- macros
- mcp
mcp - MCP (Model Context Protocol) module.
- message
cli - orchestrator
cliandnetandgpt - prelude
- π¦ Installation
- prompts
gptorcli - Prompts module.
- traits
- Traits module.
- tui
cli
MacrosΒ§
- agents
- mcp_
server mcp - Registers a single MCP server on an agent.
- with_
mcp_ servers mcp - Registers multiple MCP servers on an agent at once.

