Local Development Setup

Overview Deployment Architecture API Reference Local Setup Security

Prerequisites

  • Python 3.12+
  • uv package manager (recommended)
  • Docker Desktop (for Windows/Mac) or Docker Engine (Linux)
  • Node.js 18+ (for frontend)

Backend Setup

  1. Clone the Repository

    git clone https://github.com/Shakiran-Nannyombi/Londoolink-AI.git
cd Londoolink-AI/backend

  2. Install Dependencies

    uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

  3. Environment Variables

    Create a .env file in the backend directory:

    cp .env.example .env
# Edit .env and add your API keys (OPENAI_API_KEY, etc.)

  4. Run the Server

    uvicorn app.main:app --reload

Frontend Setup

  1. Navigate to Frontend

    cd ../app-frontend

  2. Install Dependencies

    npm install

  3. Run Development Server

    npm run dev

  4. Access App

    Open http://localhost:3000 in your browser.