Mike

Open-source release containing the Mike frontend and backend.

Contents

• frontend/ - Next.js application
• backend/ - Express API, Supabase access, document processing, and migrations
• backend/migrations/000_one_shot_schema.sql - one-shot Supabase schema for fresh databases

Setup

Install dependencies:

npm install --prefix backend
npm install --prefix frontend

Create local env files from the examples:

cp backend/.env.example backend/.env
cp frontend/.env.local.example frontend/.env.local

Run backend/migrations/000_one_shot_schema.sql in the Supabase SQL editor for a fresh database.

Start the backend:

npm run dev --prefix backend

Start the frontend:

npm run dev --prefix frontend

Open http://localhost:3000.

Required Services

• Supabase Auth and Postgres
• S3-compatible object storage, such as Cloudflare R2
• At least one supported model provider key, depending on which models you enable
• LibreOffice for DOC/DOCX to PDF conversion

LLM Configuration Options

The backend supports multiple LLM providers via environment variables in backend/.env:

Provider Keys

• GEMINI_API_KEY - Google Gemini models
• ANTHROPIC_API_KEY - Anthropic Claude models
• OPENROUTER_API_KEY - OpenRouter (aggregates multiple providers)
• RESEND_API_KEY - Resend (for email functionality)

Local LLM (vLLM) Configuration

For self-hosted vLLM endpoints:

• VLLM_BASE_URL - Base URL for your vLLM server (e.g., https://your-vllm-endpoint.com/v1)
• VLLM_API_KEY - API key for vLLM authentication
• VLLM_MAIN_MODEL - Primary model name for vLLM (e.g., BredaAI)
• VLLM_LIGHT_MODEL - Lightweight model for faster responses (e.g., your-light-model-name)

Checks

npm run build --prefix backend
npm run build --prefix frontend
npm run lint --prefix frontend

License

AGPL-3.0-only. See LICENSE.