Openagent

v1.0.0Coding Agentsstable

⚡️next-generation personal AI assistant powered by LLM, RAG and agent loops, supporting computer-use, browser-use and coding agent, demo: https://demo.openagentai.org

agentagenticagentic-aiagichatbot
Share:
4,884
Stars
0
Downloads
0
Weekly
0/5

What is Openagent?

Openagent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ⚡️next-generation personal ai assistant powered by llm, rag and agent loops, supporting computer-use, browser-use and coding agent, demo: https://demo.openagentai.org

⚡️next-generation personal AI assistant powered by LLM, RAG and agent loops, supporting computer-use, browser-use and coding agent, demo: https://demo.openagentai.org

This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ⚡️next-generation personal AI assistant powered by LLM, RAG

Use Cases

Build personal AI assistants with RAG
Support computer-use and coding agent capabilities
the-open-agent

Maintainer

LicenseApache-2.0
Languagego
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx openagent

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Openagent

OpenAgent is a next-generation personal AI assistant built on LLM agent loops, RAG, and a pluggable tool layer that supports browser automation, shell execution, web search, office file manipulation, and MCP server integration across SSE, Stdio, and StreamableHTTP transports. It connects to 30+ model providers (OpenAI, Claude, Gemini, DeepSeek, Ollama, and others) and lets users switch models per conversation, making it a flexible local alternative to hosted AI assistants. Developers and power users run OpenAgent self-hosted to get a privacy-respecting assistant that can read their documents, browse the web, write code, and manage files — all without their data leaving their machine.

Prerequisites

  • A supported OS: macOS, Linux, or Windows with WSL2
  • curl (macOS/Linux) or PowerShell (Windows) for the installer script
  • An API key for at least one supported LLM provider (OpenAI, Anthropic, Google Gemini, DeepSeek, Groq, or a local Ollama instance)
  • Port 14000 available on localhost for the web interface
  • Optional: Docker and Docker Compose for containerized deployment
1

Install OpenAgent (macOS / Linux / WSL)

Run the official install script. It downloads the OpenAgent binary and places it in your PATH automatically.

curl -fsSL https://raw.githubusercontent.com/the-open-agent/openagent/master/scripts/install.sh | bash
2

Install OpenAgent (Windows PowerShell)

On Windows, use the PowerShell install script instead.

irm https://raw.githubusercontent.com/the-open-agent/openagent/master/scripts/install.ps1 | iex
3

Or deploy with Docker Compose

For a containerized setup, use Docker Compose after cloning the repository.

git clone https://github.com/the-open-agent/openagent.git
cd openagent
docker-compose up
4

Open the web interface and configure your model provider

Navigate to http://localhost:14000 in your browser. In Settings, add your LLM provider API key. You can add multiple providers and switch between them per conversation.

# Open: http://localhost:14000
5

Add documents to the knowledge base

Upload PDFs, Word documents, or Excel files via the Knowledge Base section. OpenAgent indexes them with your chosen embedding provider and enables semantic search across all ingested content.

6

Connect MCP servers to extend capabilities

OpenAgent supports connecting external MCP servers via SSE, Stdio, or StreamableHTTP. Add MCP servers in the Settings > MCP section to give your agent access to additional tools like filesystem, GitHub, or custom APIs.

Openagent Examples

Client configuration

claude_desktop_config.json snippet for connecting an MCP client to a locally running OpenAgent instance.

{
  "mcpServers": {
    "openagent": {
      "command": "npx",
      "args": ["openagent"],
      "env": {
        "OPENAGENT_API_BASE": "http://localhost:14000"
      }
    }
  }
}

Prompts to try

Sample prompts once OpenAgent is running and your model provider is configured.

- "Search my knowledge base for all documents about the project timeline."
- "Open a browser, go to news.ycombinator.com, and summarize the top 5 stories."
- "Write a Python script that parses a CSV file and run it in the shell to show the output."
- "Convert this Word document to a PDF and save it in the same folder."
- "Switch to the DeepSeek model and answer: what are the best practices for RAG pipelines?"

Troubleshooting Openagent

Install script fails or binary not found after installation

Ensure curl is installed and you have write permissions to your local bin directory. After the install script runs, close and reopen your terminal so PATH changes take effect. On Linux, you may need to add $HOME/.local/bin to your PATH manually.

LLM calls fail with authentication errors

Go to Settings > Providers in the web UI and verify your API key is correctly entered for the active provider. For Ollama (local), ensure the Ollama service is running (`ollama serve`) and set the base URL to http://localhost:11434.

Knowledge base search returns no results after uploading documents

Check that an embedding provider is configured in Settings. The embedding model must be set up separately from the chat model. Re-upload the document after adding an embedding provider and wait for indexing to complete.

Frequently Asked Questions about Openagent

What is Openagent?

Openagent is a Model Context Protocol (MCP) server that ⚡️next-generation personal ai assistant powered by llm, rag and agent loops, supporting computer-use, browser-use and coding agent, demo: https://demo.openagentai.org It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Openagent?

Follow the installation instructions on the Openagent GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Openagent?

Openagent works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Openagent free to use?

Yes, Openagent is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Coding Agents MCP Servers

Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "openagent": { "command": "npx", "args": ["-y", "openagent"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Openagent?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides