openbb-agent-server

Pluggable, multi-tenant agent backend that speaks the OpenBB Workspace custom-agent SSE protocol and runs the agent loop on top of the LangChain DeepAgents harness. One process hosts many agent profiles; auth, model provider, tools, sub-agents, middleware, checkpointer, and persistence are independent plugin axes — anything can be swapped without forking the package.

The full OpenBB Platform — every command across every installed provider — is reachable via the optional mcp_local tool source, which spawns the openbb-mcp-server extension over stdio.

The default setup uses 100% free tokens and embedding models available from NVIDIA by registering for an API key here

Install & run

# from PyPI
pip install openbb-agent-server

# from a checkout of this repository
pip install -e '.[workspace-mcp]'
# add or combine more extras: [anthropic] [openai] [bedrock]
#                             [vertex] [google_genai] [groq]
#                             [tavily] [postgres]
#                             [pywry]  (desktop chat embedding)

export NVIDIA_API_KEY=...

openbb-agent-server

In OpenBB Workspace, add a custom agent pointing at http://localhost:8010. Workspace fetches this once and reads every agent profile the server registers in a single payload.

The [workspace-mcp] extra installs openbb-workspace-mcp from its GitHub zip (Python ≥3.13 only). To run it in-process and skip the separate workspace-mcp sidecar, set mount_workspace_mcp = true in openbb.toml after installing the extra, then point the Workspace UI's MCP-servers setting at http://localhost:8010/mcp/workspace/mcp. The mount is opt-in (default false) so installing the extra alone does not change the server's behavior.

For production, generate the config template and edit it:

openbb-agent-server --generate-config /etc/openbb/openbb.toml
openbb-agent-server --config-file /etc/openbb/openbb.toml --host 0.0.0.0

Documentation

Documentation currently lives in docs/, and may move in the future: