Welcome to Demeterics Documentation

Demeterics is the AI trust layer described in docs/PROBLEMS.md. We are not merely selling an API proxy—we are selling sleep to CTOs, confidence to marketers, and control to founders. This documentation mirrors the two entry points surfaced on the visitor site and explains how to instrument every AI interaction in minutes.

Choose Your Entry Point

1. Customer-Facing: AI Chat Widget

• 2-minute install with two lines of HTML
• Combined Demeterics + vendor key authentication for no-code tools
• Real-time transcripts, cost tracking, and compliance logs
• Read the widget guide

2. Back-of-House: Observability Proxy

• OpenAI-compatible reverse proxy for Groq, Anthropic, Gemini, custom inference
• Works with Zapier, Make, n8n, LangChain, serverless functions—anything HTTP
• Dual-key enforcement, credit billing, BigQuery-native analytics
• Follow the quick start

Most teams launch one path first, then layer on the second when stakeholders ask for deeper visibility.

Who We Serve

Directly from the manifesto:

• Citizen Developer (Sarah, Marketing Ops): Needs workflow-level cost attribution and an audit trail without writing code.
• Accidental AI Owner (Mike, SMB): Needs a chatbot that matches the website’s brand and costs $0.01 per conversation.
• Paranoid CTO (David): Needs centralized control, prompt history, and policy guardrails.
• Data Scientist in Denial (Lisa): Needs eval tooling, metadata extraction, and replay.
• Budget Guardian (Jennifer): Needs department-level spend visibility and alerts.
• Compliance Crusader (Robert): Needs hashed logs, retention controls, and exports.
• Transformation Leader (Patricia): Needs to measure every pilot and report to the board.

Each persona gets immediate relief today, near-term salvation next quarter, and long-term transformation over the next year.

Platform Pillars

1. Unified API & Widget – Share the same trust layer whether you embed chat or run back-end agents.
2. Audit-Ready Logging – Every request/response, token count, prompt, and decision is stored in BigQuery with SHA-256 hashes.
3. Credit + BYOK Billing – Start with Demeterics credits (never expire), or bring your own provider keys while keeping observability.
4. Metadata Everywhere – Add app/flow/variant/environment headers to power A/B tests, prompt experiments, and ROI dashboards.
5. Roadmap-Driven Guardrails – Prompt versioning, team budgets, evaluation frameworks, policy engine, and PII detection are laid out explicitly in docs/PROBLEMS.md.

Quick Start Checklist

1. Create keys – Visit Settings → API Keys after signing in.
2. Pick your install – Either embed the widget (/docs/ai-chat-widget) or swap your API base URL (/docs/getting-started).
3. Send metadata – Include headers such as x-dem-app, x-dem-flow, and x-dem-variant for better analytics.
4. Invite stakeholders – Give marketing, finance, compliance, and engineering their own views of the dashboard.
5. Run validations – Use template validation tools and the built-in replay features.

Supported Providers

*Model availability changes constantly—ask your vendor or configure via environment variables instead of hard-coding names.

Documentation Map

Getting Started

• Quick Start – Swap the API URL or embed the widget.
• Authentication – API keys, dual-key enforcement, session policies.
• Credits & Pricing – Understand credits, BYOK, alerts, and refunds.

API & Features

• API Reference – Endpoints, payloads, metadata headers.
• AI Chat Widget – Prompt strategy, branding, multi-domain support.
• Prompt Engineering – Triple-slash docs, metadata, and drift tracking.
• Conversion Tracking – Cohort analytics and ROI measurement.

Integrations & SDKs

• WordPress, Wix, Squarespace, GoDaddy, GitHub Pages, and more in /docs/integration-*.
• SDK coverage for Python, Node.js, Go, and custom HTTP in /docs/sdks.

Ready to Go?

If you want to instrument all AI traffic now, head to the Quick Start Guide. If you need to prove ROI for a specific front-end use case, visit the AI Chat Widget guide. Either way, Demeterics provides the lights, gauges, and guardrails described in the manifesto.