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 |
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file openbb_agent_server-0.1.1.tar.gz.
File metadata
- Download URL: openbb_agent_server-0.1.1.tar.gz
- Upload date:
- Size: 274.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1fe9bfa7ae5615a7178504570c49e5a3934556998c86f2792d4bb1ca1189cfc7
|
|
| MD5 |
1d4b2d61266af298c92d78f930661551
|
|
| BLAKE2b-256 |
240867098cdf4fdc1f78177a94771f140789008e61e6df24738c3a7a638407dd
|
Provenance
The following attestation bundles were made for openbb_agent_server-0.1.1.tar.gz:
Publisher:
publish-openbb-agent-server.yml on deeleeramone/openbb-agent-server
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
openbb_agent_server-0.1.1.tar.gz -
Subject digest:
1fe9bfa7ae5615a7178504570c49e5a3934556998c86f2792d4bb1ca1189cfc7 - Sigstore transparency entry: 2018221923
- Sigstore integration time:
-
Permalink:
deeleeramone/openbb-agent-server@debbe99442e8af4ca6d3a527f477ed57242ce7a9 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/deeleeramone
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-openbb-agent-server.yml@debbe99442e8af4ca6d3a527f477ed57242ce7a9 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file openbb_agent_server-0.1.1-py3-none-any.whl.
File metadata
- Download URL: openbb_agent_server-0.1.1-py3-none-any.whl
- Upload date:
- Size: 349.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2dcbddc6bd23eaa4bb4e2a8c50793b2f4e9291991b56a26b9a3c19a272db7dc0
|
|
| MD5 |
cfbe18aa3e7e189422158d747a9e8261
|
|
| BLAKE2b-256 |
5214e48dca7c07333ca4fb76234c20b2a2f574bd1608b638b8fe105d5a195a8f
|
Provenance
The following attestation bundles were made for openbb_agent_server-0.1.1-py3-none-any.whl:
Publisher:
publish-openbb-agent-server.yml on deeleeramone/openbb-agent-server
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
openbb_agent_server-0.1.1-py3-none-any.whl -
Subject digest:
2dcbddc6bd23eaa4bb4e2a8c50793b2f4e9291991b56a26b9a3c19a272db7dc0 - Sigstore transparency entry: 2018222076
- Sigstore integration time:
-
Permalink:
deeleeramone/openbb-agent-server@debbe99442e8af4ca6d3a527f477ed57242ce7a9 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/deeleeramone
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-openbb-agent-server.yml@debbe99442e8af4ca6d3a527f477ed57242ce7a9 -
Trigger Event:
workflow_dispatch
-
Statement type:
