Skip to main content
Documentation

Quick start guide

Get OpenDDE running on your local machine in under 5 minutes. All you need is Docker Desktop.

1. Prerequisites

Make sure you have the following installed:

  • Docker Desktop (v4.0+) — Download here
  • Git — to clone the repository
  • 8 GB RAM minimum (16 GB recommended)

See System requirements for full details.

2. Clone the repository

git clone https://github.com/contact-ajmal/opendde.git
cd opendde

3. Set up environment variables

Copy the example environment file and add your API keys:

cp .env.example .env

Edit .env and set the required values:

# Required
SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_anon_key

# Optional (for AI assistant)
ANTHROPIC_API_KEY=your_anthropic_key

# Optional (for AlphaFold complex prediction)
ALPHAFOLD_API_KEY=your_alphafold_key

4. Build and start all services

docker compose up --build

This will build and start 6 containers: the Next.js frontend, FastAPI backend, P2Rank pocket predictor, ImmuneBuilder antibody modeler, RDKit cheminformatics service, and Redis cache.

First build takes 5–10 minutes. Subsequent starts take ~30 seconds.

5. Open the app

Once all containers are healthy, open your browser to:

http://localhost:3000

6. Search your first target

  1. Navigate to the dashboard
  2. Type a protein name or UniProt ID into the search bar (try EGFR or P00533)
  3. Wait for the target to resolve — you’ll see the 3D structure load
  4. Binding pockets appear as colored spheres on the protein surface
  5. Click any pocket to explore its residues, known ligands, and druggability score

What’s next?