Configuration

All settings live in the NOCTURNE dict in your settings.py.

NOCTURNE = {
    "SERVICE_NAME": "my-api",
    "ANOMALY_THRESHOLD": 2.0,
    "AI_BACKEND": "anthropic",
    "ANTHROPIC_API_KEY": env("ANTHROPIC_API_KEY"),
}

Full Reference

Core

Key	Default	Description
`SERVICE_NAME`	`"default"`	Tag applied to all log entries by the middleware
`ANOMALY_THRESHOLD`	`2.0`	Z-score cutoff for anomaly detection
`RETENTION_DAYS`	`30`	Auto-purge log entries older than N days
`EXCLUDE_PATHS`	`["/health", "/static", "/favicon.ico"]`	Paths the middleware skips
`LOGIN_URL`	`"/admin/login/"`	Redirect for unauthenticated dashboard access

AI

Key	Default	Description
`AI_BACKEND`	`"ollama"`	Active LLM: `anthropic` / `openai` / `ollama` / `gemini`
`AI_DIAGNOSIS_ENABLED`	`True`	Master toggle for all LLM calls
`ANTHROPIC_API_KEY`	`""`	Claude API key
`ANTHROPIC_MODEL`	`"claude-sonnet-4-6"`	Claude model ID
`OLLAMA_BASE_URL`	`"http://localhost:11434"`	Ollama server URL
`OLLAMA_MODEL`	`"llama3.2"`	Ollama model name
`OPENAI_API_KEY`	`""`	OpenAI API key
`OPENAI_MODEL`	`"gpt-4o"`	OpenAI model ID
`OPENAI_BASE_URL`	`"https://api.openai.com/v1"`	Override for Azure / Groq / vLLM
`GEMINI_API_KEY`	`""`	Google Gemini API key
`GEMINI_MODEL`	`"gemini-1.5-flash"`	Gemini model ID

Webhooks

Key	Default	Description
`WEBHOOK_SECRET`	`""`	HMAC-SHA256 secret for signature validation on received webhooks