OSOR Agent

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:

1. Clone this repository to your local machine.

2. Create and activate a conda environment (recommended):

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

3. Install the necessary dependencies:

   poetry install

4. 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

1. Go to OpenBB Workspace.

2. Click on the OpenBB Copilot at the bottom right.

3. Click on the "+" icon to add a new AI agent.

4. 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)

5. Select the agent on the bottom right agents menu.

6. Voila - you are ready to use your new financial agent with any model of your choice powered by OpenRouter.