xlang-ai/openagents

★ 4,794PythonAudience · developerComplexity · 4/5LicenseSetup · hard

Mindmap

mindmap
  root((openagents))
    What it does
      Self-hosted AI assistants
      Chat-based task execution
      Three ready-to-use agents
    Agents
      Data Agent code and SQL
      Plugins Agent 200 tools
      Web Agent browser control
    For Users
      Chat interface
      Graceful error handling
    For Developers
      Swap language models
      Add custom agent types
      Research and study
    Tech Stack
      Python and Docker
      Chrome browser
      Apache 2.0 license

mindmap root((openagents)) What it does Self-hosted AI assistants Chat-based task execution Three ready-to-use agents Agents Data Agent code and SQL Plugins Agent 200 tools Web Agent browser control For Users Chat interface Graceful error handling For Developers Swap language models Add custom agent types Research and study Tech Stack Python and Docker Chrome browser Apache 2.0 license

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Analyze spreadsheets or databases by chatting with the Data Agent, which writes and runs the code on your behalf.

USE CASE 2

Let the Plugins Agent automatically pick from 200+ external tools to answer questions about weather, shopping, or scientific calculations.

USE CASE 3

Automate web tasks by asking the Web Agent to navigate websites, fill out forms, or retrieve information from any page.

USE CASE 4

Build a custom AI assistant platform by swapping in different language models or adding new agent types to the open codebase.

Tech stack

PythonDockerSQLChromeREST APIs

Getting it running

Difficulty · hard Time to first run · 1h+

Requires Docker and multiple API keys, each component needs its own environment file configured before starting containers.

Free to use, modify, and distribute for any purpose including commercial, as long as you keep the Apache 2.0 license notice.

In plain English

OpenAgents is an open-source platform from a university research lab that lets you run AI assistants capable of doing real tasks through a chat interface. Think of it as a self-hosted version of ChatGPT's advanced features, but with code you can read, modify, and deploy yourself. The project comes with a web UI and a backend server, so you can set it up on your own computer or server without relying on a third-party service. The platform ships with three ready-to-use agents. The first is a Data Agent that can write and run Python or SQL code to analyze spreadsheets, databases, and files, then produce charts or summaries from the results. The second is a Plugins Agent that connects to over 200 external tools covering shopping, weather lookups, scientific calculations, and much more, choosing the right tools automatically based on what you ask. The third is a Web Agent that controls a real Chrome browser to navigate websites, fill forms, and retrieve information on your behalf. The intended audience is split between everyday users and developers. Regular users get a chat interface designed to handle common failures gracefully and respond quickly. Developers and researchers get a fully open codebase they can extend with new agent types, swap in different underlying language models, or use as a starting point for studying how these systems behave in practice. The paper accompanying the project, published on arXiv, documents both the design decisions and the open challenges the authors encountered when deploying agents to real users. Setting up a local copy requires Docker and a few API keys. The README walks through cloning the repository, configuring environment files for each component, and starting the frontend and backend containers. An online demo was hosted by the lab for free use, though the README notes that high traffic sometimes affects response times. The project is licensed under Apache 2.0.

Copy-paste prompts

Prompt 1

Help me set up OpenAgents locally with Docker so I can use the Data Agent to analyze a CSV file through the chat interface.

Prompt 2

How do I add a custom agent to OpenAgents that connects to my company's internal REST API?

Prompt 3

Show me how to swap the underlying language model in OpenAgents so I can use a different AI provider instead of the default.

Prompt 4

I want the Web Agent in OpenAgents to automatically fill out a form on a website every day, how do I configure that?

Prompt 5

How do I extend the Plugins Agent in OpenAgents to support a tool that isn't in its default 200+ plugin list?

Open on GitHub → Explain another repo

← xlang-ai on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.