Open Specter is an open-source AI workspace for legal teams. Organize matters, review documents, run AI conversations, build tabular reviews, and automate repetitive legal workflows.

Maintained by Quantera.ai.

• Projects — Organize documents by matter, client, or workflow.
• Document Management — File uploads, versioning, and document parsing for AI review.
• Assistant Chat — Question answering, summarization, drafting, and citations over selected context.
• Tabular Reviews — Extract structured data across document batches into review tables.
• Workflows — Reusable prompt chains and tabular review templates.
• Recent Activity — Timeline of recent chats, reviews, and workflow runs.
• Keyboard Shortcuts — Command-style navigation and quick actions.
• Voice Input — Browser-native speech-to-text for assistant prompts.

.
├── backend/
│   ├── migrations/
│   │   ├── 000_one_shot_schema.sql       # Initial database schema and RLS policies
│   │   └── 001_rls_content_tables.sql    # Incremental RLS updates
│   └── src/
│       ├── routes/                       # API routes
│       ├── lib/                          # Supabase, storage, AI, and document helpers
│       └── index.ts                      # Server entry point
├── frontend/
│   ├── public/                           # Static assets
│   └── src/
│       ├── app/                          # Next.js App Router pages
│       ├── components/                   # Shared UI and product components
│       ├── contexts/                     # State and auth providers
│       └── lib/                          # API and browser utilities
└── README.md

• Node.js 20+
• Yarn 1.x
• Supabase account & project
• (Optional) Cloudflare R2 or S3-compatible storage
• (Optional) LibreOffice on the host system for DOCX conversion

Copy the example environment files:

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

PORT=3001
FRONTEND_URL=http://localhost:3000

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SECRET_KEY=your-supabase-service-role-key

# Storage (optional for local development; defaults to local disk)
R2_ENDPOINT_URL=https://your-account-id.r2.cloudflarestorage.com
R2_ACCESS_KEY_ID=your-r2-access-key
R2_SECRET_ACCESS_KEY=your-r2-secret-key
R2_BUCKET_NAME=open-specter

# AI Providers (enable any combination)
GEMINI_API_KEY=your-gemini-key
ANTHROPIC_API_KEY=your-anthropic-key
OPENROUTER_API_KEY=your-openrouter-key
RESEND_API_KEY=your-resend-key

# Legal Research Providers (optional; requires provider API keys)
LEGAL_DATA_HUNTER_API_KEY=your-legaldatahunter-key
VAQUILL_API_KEY=vq_key_your_vaquill_key

NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY=your-supabase-publishable-key
NEXT_PUBLIC_API_BASE_URL=http://localhost:3001

Apply the schema and Row Level Security policies to your Supabase database:

1. In your Supabase project, open the SQL Editor.
2. Run backend/migrations/000_one_shot_schema.sql.
3. Verify that the core tables (projects, documents, chats, tabular_reviews, workflows) appear in the Table Editor.

If updating an existing deployment where only RLS policies need refreshing, run backend/migrations/001_rls_content_tables.sql instead.

yarn --cwd backend install
yarn --cwd frontend install

(If your environment flags Node version mismatches, append --ignore-engines).

Start the backend:

yarn --cwd backend dev

Start the frontend:

yarn --cwd frontend dev

The application will be accessible at http://localhost:3000.

Build both packages to ensure TypeScript compilation and dependencies pass:

yarn --cwd backend build
yarn --cwd frontend build

Health check:

curl http://localhost:3001/health
# {"ok":true}

Press Cmd/Ctrl + / to open the shortcuts modal, or use:

• Missing table or PostgREST cache error: Ensure backend/migrations/000_one_shot_schema.sql was executed successfully in the public schema in Supabase.
• Upload failures in production: Verify your R2/S3 bucket name and access keys in backend/.env. If unconfigured, files default to local storage at /app/data/open-specter-storage.

Please report vulnerabilities privately. See SECURITY.md for disclosure guidelines and production hardening recommendations.

Distributed under the GNU Affero General Public License v3.0 (AGPL-3.0). See LICENSE for terms.

Open Specter is a fork of Mike (willchen96/mike), released under AGPL-3.0.

Open Specter builds upon that foundation with:

• A neutral grayscale enterprise-grade UI overhaul (Framer Motion)
• Supabase anonymous sign-ins / Guest Mode + 7-day cleanup of orphaned accounts
• 10+ additional legal workflow templates
• LegalDataHunter integration for jurisdiction-scoped case-law and legislation retrieval with inline citations across 178 jurisdictions