Introduction
The open-source infrastructure for production AI agents and knowledge bases.
Introduction
"Build once, deploy everywhere."
OpenAgent is a single-binary AI agent platform — download, run, and your first agent is live in minutes.
Orchestration, RAG, MCP, and tool-calling — all self-hosted, backed by your own data.
Install
Get OpenAgent running and send your first AI-powered message in under 5 minutes.
Build a Chat Assistant
Step-by-step guide to creating your first agent.
What is OpenAgent?
OpenAgent is a self-hosted AI agent platform that connects your data, tools, and models into a production-ready system. Unlike simple chat interfaces, OpenAgent provides:
- Managed RAG: Turn PDFs and wikis into grounded context with automatic parsing and semantic search.
- Model Orchestration: Switch between 28+ providers with standardized abstractions for models, embeddings, and storage.
- Tool Integration: Extend agents with MCP servers and built-in automation.
- Privacy & Access Control: Role-based access control (RBAC), SSO integration, and comprehensive audit logs.
Who is it for? Developers and teams who want a private, self-hosted AI assistant that can reason over their own data — without relying on hosted APIs.
What makes it different?
- Single Binary: Ships as one executable — download and double-click to run. No installation wizard, no dependencies to manage.
- Self-hosted: Runs on your own infrastructure. Full control, no vendor lock-in.
- Provider Agnostic: Standardized abstraction for models, embeddings, and storage.
- Scalable Workflows: Connect agents to external tools, data, and automation through a consistent provider model.
- Audit Ready: Track every token, record every tool call, and monitor agent performance at scale.
Model Orchestration
Seamlessly switch between 28+ providers. Configure fallback models for high availability.
Managed RAG
Professional document indexing and retrieval. Turn PDFs and wikis into grounded context.
Tool Integration
Extend agents with MCP servers and built-in automation tools.
Privacy & Access Control
Role-based access control (RBAC), SSO integration, and comprehensive audit logs.
Quick start
The simplest way to run OpenAgent is to download the binary from the Releases page and double-click it. No installation required — it works natively on Windows, macOS, and Linux.
Windows — download openagent_windows_x86.exe and run it directly. No WSL, no Docker needed.
Linux — download the binary and make it executable:
chmod +x openagent_linux_x86 && ./openagent_linux_x86macOS — download the binary for your chip (openagent_darwin_arm64 for Apple Silicon, openagent_darwin_x86 for Intel) and run:
chmod +x openagent_darwin_arm64 && ./openagent_darwin_arm64Once running, navigate to http://localhost:14000.
Navigate to Providers → Add Provider.
- Category:
Model - Type:
DeepSeek(Recommended for cost) orOpenAI - API Key: Enter your credentials.
- Model (Sub Type): Select a supported model ID.
Navigate to Stores → Add Store.
- Name:
primary-assistant - Model Provider: Select the provider from Step 2.
- System Prompt: "You are a professional research assistant."
Open the Chat interface from the sidebar. Select your agent and send a test message.
Milestone Reached: You now have a functional, self-hosted AI orchestration engine.
Need a deeper walkthrough? See Build a Chat Assistant.
Start here
Install
Deploy OpenAgent and reach the First Message milestone.
Chat Assistant
Create a chat assistant backed by any LLM provider.
Knowledge Base
Enable RAG so your assistant answers from your own documents.
Tools & Automation
Give your assistant the ability to browse, call APIs, or run automations.
Admin & Access Control
Manage users, organizations, and SSO integration.
Note on Migration: This documentation covers the new Agent-first architecture. Legacy cloud and multimedia modules from previous versions are now deprecated.