Skip to main content

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.

Maieutic reads its configuration from a .env or .env.local file in the project root. Copy .env.example to .env.local and set the two variables below — that is everything required to run the app locally.

​
Environment variables

​
ANTHROPIC_API_KEY
string
required
Your Anthropic API key. Get one from console.anthropic.com. Maieutic uses this to call the claude-opus-4-7 model at seven points in the student and instructor experience — spec examination, in-editor chat, intent-diff analysis, live session summaries, divergence classification, cohort narrative generation, and exercise scaffolding.
ANTHROPIC_API_KEY=sk-ant-...
​
DATABASE_URL
string
default:"file:./dev.db"
required
The database connection string. For local development, use a SQLite file path. The default value in .env.example creates dev.db in the project root.
DATABASE_URL="file:./dev.db"
If you want to migrate to Postgres, change the provider field in prisma/schema.prisma from "sqlite" to "postgresql" and update this URL to a valid Postgres connection string. No other code changes are required.

​
Language support

Maieutic supports English and Spanish. Students can switch languages using the language switcher on the landing page. Translations are generated on demand the first time a student in a given language loads an exercise, then stored in the ExerciseTranslation table and served from cache on every subsequent request. No additional environment variable is needed to enable this — it uses the same ANTHROPIC_API_KEY. To invalidate a translation (for example, after editing an exercise’s text), delete the relevant rows from the ExerciseTranslation table and the translation will be regenerated on the next request.

​
The .env.example file

.env.example is safe to commit to version control — it contains no real credentials. Copy it to .env.local (which is gitignored) and fill in your values there. Never commit .env.local.
The full contents of .env.example: 
# Copy this file to .env.local and fill in your key.
# .env.local is gitignored; .env.example is safe to commit.

ANTHROPIC_API_KEY=sk-ant-your-key-here
DATABASE_URL="file:./dev.db"

Build docs developers (and LLMs) love

Get started for freeTalk to us