openbb-agent-server 0.1.0

OpenBB Agent Server: pluggable, multi-tenant agent backend wired to the OpenBB Workspace UI.

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:

Audience	Start here
First-time user	Getting started → Architecture → Workspace integration
Desktop embedding	PyWry chat (ACP) — openbb-agent-canvas opens a window whose main page is the agent's live canvas (charts, tables, HTML) with the chat attached; or attach the chat to any PyWry widget via the [pywry] extra. Same openbb.toml, same loop, no HTTP server
Operator / SRE	Configuration → Auth → Persistence → Observability
Plugin author	Plugin system → writing a tool source / model provider / middleware / sub-agent / auth backend → Conventions → Testing
API lookup	Reference — module-by-module, mirrors the package tree