Maieutic runs locally as a Next.js 16 app backed by a SQLite database. The only external dependency is an Anthropic API key — everything else, including the database, lives on your machine. No cloud account or hosted service is required.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/bcanata/maieutic/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
- Node.js 20 or higher — verify with
node --version - An Anthropic API key (
sk-ant-...) — create one at console.anthropic.com - Git — to clone the repository
Setup
Copy the environment file
.env.local and set both variables:ANTHROPIC_API_KEY is required for all Opus calls. DATABASE_URL points to the local SQLite file that Prisma creates on first migration.Apply database migrations
dev.db and generates the Prisma client. See Database setup and schema for details on the data model.Seed demo data (optional)
Open the app
Navigate to http://localhost:3000.The landing page asks whether you are a student or a teacher — no login required. Students are routed to the exercise list; instructors are routed to the live dashboard.
Available scripts
| Command | Description |
|---|---|
npm run dev | Start the development server |
npm run build | Build for production |
npm start | Start the production server |
npm run lint | Run ESLint |
npm test | Run unit tests with Vitest |
npm run test:opus | Run Opus integration tests (requires a live API key and model) |
npm run test:e2e | Run Playwright end-to-end tests |
npm run reset-demo | Wipe the database and replay demo fixtures |
npm run capture-fixtures | Run real Opus sessions and save the responses as test fixtures |