Quickstart Guide

Step-by-Step Setup

Step 1: Clone Repository & Setup Environment

git clone https://github.com/omghante/metapilot.git
cd metapilot

Step 2: Initialize Backend (

services/api

)

1. Create Python virtual environment and install dependencies:
   bash

   cd services/api
   python -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt
   

2. Generate a valid Fernet encryption key and populate

   .env

   :
   bash

   python scripts/generate_fernet_key.py --write-env
   

3. Run database migrations (defaults to local SQLite

   db.sqlite3

   ):
   bash

   python manage.py migrate
   

4. Create a Super Admin account:
   bash

   python scripts/create_superadmin.py --email admin@metapilot.in --password AdminSecret123 --first-name Super --last-name Admin
   

5. Start Backend Server:
   bash

   # From root repository directory
   ./scripts/backend.sh
   

   The Django ASGI server will start listening on

   http://localhost:8000

   .

Step 3: Initialize Frontend (

apps

)

cd apps
yarn install
yarn dev

http://localhost:3000

Login to MetaPilot

1. Open your browser and navigate to

   http://localhost:3000/auth/login

   .
2. Login with your Super Admin credentials:
   • Email:

     admin@metapilot.in

   • Password:

     AdminSecret123

3. Access the Super Admin Dashboard at

   http://localhost:3000/dashboard

   .