README.md

---
title: Antaram
emoji: 🔺
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: false
---

# Antaram — Agentic SLM API

OpenAI-compatible API (chat + web search), multi-tenant with per-key isolation,
Postgres-backed, behind Cloudflare → your domain.

- **Chat:** `POST /v1/chat/completions` (OpenAI format; `session_id` for memory; 1 image attachment)
- **Models:** `GET /v1/models`
- **Health:** `GET /health` · **Usage:** `GET /usage`, `GET /usage/{session_id}`
- **Admin:** `POST /admin/login`, `POST/GET/DELETE /admin/keys`, `GET/PUT /admin/system-prompt`
- **UI:** `/` (test console)

## Secrets (set in the Space UI)
`AGY_CREDS_JSON`, `DATABASE_URL`, `SUPERADMIN_PASSWORD` (and optionally `AGY_CREDS_PATH`).

Everything else (paths, ports, TTLs, response cap) is configured in the Dockerfile /
defaults. See `DEPLOY.md`.