OSOR Agent

December 2, 2025 · View on GitHub

Open Source OpenRouter Agent - Intelligent financial analysis powered by OpenRouter models with dynamic visualizations, tables, and citations. Meant to be used in OpenBB Workspace. *Built with the help of Claude Code.

Features

Access to data from the dashboard and in context
Create table and chart artifact
Widget citations
Step-by-step reasoning
MCP tool use

Getting started

Prerequisites

Python 3.10+ (recommended: use conda or miniconda)
Poetry for dependency management
An OpenRouter API key from OpenRouter

Installation and Running

Here's how to get your copilot up and running:

Clone this repository to your local machine.

Create and activate a conda environment (recommended):

conda create -n openbb-open-router-agent python=3.11 -y
conda activate openbb-open-router-agent

Install the necessary dependencies:
```
poetry install
```

Start the API server:

poetry run uvicorn main:app --port 8000 --reload

This command runs the FastAPI application, making it accessible on your network.

Add to OpenBB Workspace

Go to OpenBB Workspace.
Click on the OpenBB Copilot at the bottom right.
Click on the "+" icon to add a new AI agent.

Add port where the agent is running and click "Add Authentication Header"

URL: http://127.0.0.1:8000

First auth header:

Key: X-OPENROUTER-MODEL
Value: x-ai/grok-4.1-fast:free (get it from OpenRouter Models)

Second auth header:

Key: X-API-KEY
Value: (get it from https://openrouter.ai/settings/keys)

Select the agent on the bottom right agents menu.
Voila - you are ready to use your new financial agent with any model of your choice powered by OpenRouter.