Manual Install

Prerequisites

• Python 3.12+

• PostgreSQL 15+ with pgvector extension

• Redis 7+

Database Setup

1

Create a new database and enable pgvector

createdb qubit
\c qubit
CREATE EXTENSION vector;

2

Set up your environment variables

Variable	Description	Required
DB_PASSWORD	PostgreSQL password	Yes
AUTH_SECRET_KEY	Secret key for JWT tokens	Yes
OPENAI_API_KEY	OpenAI API key for semantic search	Yes
ADMIN_USERNAME	Admin username	Yes
ADMIN_EMAIL	Admin email	Yes
ADMIN_PASSWORD	Admin password	Yes

3

Set up your environment variables

export DATABASE_URL="postgresql://postgres:password@localhost:5432/qubit"
export REDIS_URL="redis://localhost:6379/0"
export AUTH_SECRET_KEY="your_secret_key_here"
export OPENAI_API_KEY="your_openai_key_here"

Install & Run

1

Install dependencies and run database migrations

pip install -r requirements.txt
alembic upgrade head

2

Create an admin user

python -m qubit.scripts.create_admin --username admin --email [email protected] --password your_password

3

Start the application

python -m qubit.main --config data/config.yaml

The application will be available at http://localhost:8000.