Get Started

Quick start guide to get AI Hedge Fund up and running. Follow these simple steps.

🚀 Access Application 📖 Complete User Guide

🚀 Quick Access

If the application is already running, you can access it directly:

Open AI Hedge Fund Application

Default URL: http://localhost:5173

Installation Steps

Prerequisites

Make sure you have installed:

Node.js (v18+) - Download
Python 3.11+ - Download
Poetry - Python dependency manager

Clone Repository

git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund

Set Up Environment

cp .env.example .env

Edit .env file and add at least one LLM API key. See API Keys documentation.

Install Dependencies

# Install Poetry (if not installed)
curl -sSL https://install.python-poetry.org | python3 -

# Install Python dependencies
poetry install

# Install frontend dependencies
cd app/frontend
npm install

Run Application

Option 1: Convenience Script (Easiest)

cd app
./run.sh  # Mac/Linux
# or
run.bat   # Windows

Option 2: Manual Start

Terminal 1 - Backend:

cd app/backend
poetry run uvicorn app.backend.main:app --reload --host 127.0.0.1 --port 8000

Terminal 2 - Frontend:

cd app/frontend
npm run dev

Access the Application

Once running, open your browser and navigate to:

Frontend: http://localhost:5173
API Docs: http://localhost:8000/docs

Next Steps

1. Configure API Keys

Add at least one LLM API key in Settings → API Keys

Learn More →

2. Build Your First Flow

Create a trading flow using the visual flow builder

Complete Guide →

3. Explore Agents

Learn about the 18 AI investment agents

View Agents →

Ready to Start?

Access the application and start building your trading strategies!

🚀 Access Application Now