Skip to main content

Quick Start Guide

Get PolyOracle AI up and running in minutes with this step-by-step guide.

Prerequisites​

Before starting, make sure you have:

  • Node.js 18+ and pnpm for the frontend
  • Python 3.11+ for the backend
  • A Web3 wallet (MetaMask, Phantom, etc.)
  • Required API keys (see API Configuration)

Quick Setup​

1. Clone the Repository​

git clone https://github.com/The400MillionDollarCorp/PolyOracle.git
cd polyoracle

2. Environment Variables​

Copy the environment template and fill in your API keys:

cp .env.example .env

Edit .env with your API keys:

OPENAI_API_KEY=your_openai_key
EXA_API_KEY=your_exa_key
POLYMARKET_API_KEY=your_polymarket_key
POLYMARKET_API_SECRET=your_polymarket_secret
POLYGON_WALLET_PRIVATE_KEY=your_wallet_private_key
# ... other keys

3. Backend Setup​

cd backend
pip install -e ".[dev]"
make lg-server

The backend will start on http://localhost:2024

4. Frontend Setup​

In a new terminal:

cd frontend
pnpm install
pnpm dev

The frontend will be available at http://localhost:3000

First Run​

  1. Connect Your Wallet: Use the Web3 wallet integration in the frontend
  2. Configure Polymarket: Follow the Polymarket Setup guide
  3. Test the Agent: Try analyzing a market with the AI agent

Verification​

To verify everything is working:

  1. Backend Health: Visit http://localhost:2024 - should show LangGraph server
  2. Frontend: Visit http://localhost:3000 - should show the PolyTrade interface
  3. Agent Test: Use the frontend to test market analysis

Next Steps​

Troubleshooting​

Backend won't start?

  • Check Python version: python --version (should be 3.11+)
  • Verify dependencies: pip list | grep langgraph

Frontend issues?

  • Check Node.js version: node --version (should be 18+)
  • Clear cache: pnpm store prune

API errors?

  • Verify API keys in .env file
  • Check API key permissions and limits

Need more help? See the Troubleshooting Guide or check the FAQ.