Is AgenticTrading free?

Check its license. It has its own license: read it before using it for work.

Does AgenticTrading use paid AI services?

Can use OpenAI, Anthropic, DeepSeek or OpenRouter. Its settings have keys for these paid APIs. Its README says whether one is required.

Is AgenticTrading still maintained?

Yes, active. Last change 6 days ago.

Can I trust AgenticTrading?

Some track record. 894 stars, 1 years old, by an organization. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to install on macOS

Open-Finance-Lab/AgenticTrading

Python

Before you start

Is it free?: Check its licenseIt has its own license: read it before using it for work.
Paid AI services?: Can use OpenAI, Anthropic, DeepSeek or OpenRouterIts settings have keys for these paid APIs. Its README says whether one is required.
Still maintained?: Yes, activeLast change 6 days ago.
Can I trust it?: Some track record894 stars, 1 years old, by an organization. Get it from the official repo and read what it installs.

Difficulty: Involved
Time: 30 min or more
Stars: ★ 894
Activity: Updated this month

Saved setup from 5 h ago

Will it work on macOS?

Yes, it runs on macOS

You'll build it yourself with Python.
It also needs PostgreSQL running (Docker handles this).

Your system

macOS Windows Linux

Start here

Website ↗agentic-trading-lab.vercel.appThe project's own site.

Heads-upIt also needs PostgreSQL and 38 settings in .env (8 secret).

5 steps on macOS

Download setup.sh

Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

Clone the repository

Needs Git: xcode-select --install

git clone https://github.com/Open-Finance-Lab/AgenticTrading.git
cd AgenticTrading

2
Install the required runtimes
Python 3.13
```
brew install uv
```
3
Configure environment variables
Fill in secrets: ALPACA_API_KEY, ALPACA_SECRET_KEY, COMMONSTACK_API_KEY, FINGPT_API_KEY, OPENROUTER_API_KEY, IFIND_REFRESH_TOKEN, IFIND_ACCESS_TOKEN, DISCORD_BOT_TOKEN
```
cp .env.example .env
```
Start backing services
Needs: PostgreSQL (no compose file — install locally or run via Docker)
5
Install dependencies
```
uv sync
```

From the README: Run Locally

uv venv --python 3.13 .venv
UV_HTTP_TIMEOUT=180 uv pip install --python .venv/bin/python -r requirements.txt -r requirements-vnpy.txt pytest pytest-timeout
dashboard/scripts/run_local_safe.sh        # http://127.0.0.1:8765/app on a seed-DB copy; blanks broker, LLM, DB, mail, Stripe and iFinD keys

On Windows, run these from Git Bash with .venv/Scripts/python.exe in place of .venv/bin/python.

Full guide (backtests, tests, credentials, troubleshooting): docs/local-run.md.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 12 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Python 3.13runtime
1×uv package manager
1×PostgreSQL service

38× settings in .env

ALPACA_API_KEYsecret
ALPACA_SECRET_KEYsecret
ALPACA_BASE_URL
OPENAI_API_KEYsecretoptional
ANTHROPIC_API_KEYsecretoptional
DEEPSEEK_API_KEYsecretoptional
AI_HEDGE_FUND_PYTHON
COMMONSTACK_API_KEYsecret
COMMONSTACK_BASE_URL
FINGPT_API_KEYsecret
OPENROUTER_API_KEYsecret
OPENROUTER_BASE_URL
OPENROUTER_REASONING_EFFORT
ENABLE_IFIND_ASHARE
IFIND_REFRESH_TOKENsecret
IFIND_ACCESS_TOKENsecret
IFIND_BASE_URL
DISCORD_BOT_TOKENsecret
DISCORD_GUILD_ID
DISCORD_CHANNEL_IDoptional
ATL_API_BASEoptional
DISCORD_BOT_API_SECRETsecretoptional
DISCORD_CLIENT_IDoptional
DISCORD_CLIENT_SECRETsecretoptional
DISCORD_REDIRECT_URIoptional
DISCORD_GUILD_CHANNEL_URLoptional
PUBLIC_APP_URLoptional
ROBINHOOD_MCP_URL
ROBINHOOD_REDIRECT_URI
ROBINHOOD_EXECUTE
ROBINHOOD_MAX_ORDER_USD
DATABASE_PATH
BREVO_API_KEYsecretoptional
ACCOUNT_EMAIL_FROMoptional
ACCOUNT_EMAIL_FROM_NAMEoptional
PORT
DEBUG
PYTHONUNBUFFERED

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/Open-Finance-Lab/AgenticTrading/badge.svg)](https://gitmanual.com/Open-Finance-Lab/AgenticTrading)

Good to know

Dockerfile available (base image: python:3.13-slim).
Has CLAUDE.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: dashboard/landing/package.json, orchestration/FinAgents/agent_pools/alpha_agent_demo/requirements.txt, orchestration/FinAgents/agent_pools/execution_agent_demo/execution_agent_demo/requirements.txt, orchestration/FinAgents/agent_pools/risk_agent_demo/requirements.txt and 1 more

Details

License: Not detected
Open issues: 131
Branch: main

Files we read (12)

.env.example

.github/workflows/ci.yml

.github/workflows/codeql.yml

.github/workflows/daily-leaderboard.yml

.github/workflows/keep-warm.yml

.github/workflows/live-leaderboard.yml

.github/workflows/publish-pypi.yml

.python-version

Dockerfile

README.md

pyproject.toml

requirements.txt

1,696 files in the repo

Yes, it runs on macOS

Start here

5 steps on macOS

Clone the repository

Install the required runtimes

Configure environment variables

Start backing services

Install dependencies

From the README: Run Locally

Did you get it running?

Still stuck? Get a written guide