README.md

---
title: Tritan API
emoji: 🔱
colorFrom: purple
colorTo: indigo
sdk: docker
pinned: false
license: mit
app_port: 7860
---

# Tritan API - AI-Native Workflow Engine

Backend API for the Tritan workflow engine.

## Endpoints

- `GET /` - API info
- `GET /health` - Health check
- `GET /docs` - Swagger documentation
- `POST /api/planner/generate` - Generate workflow from task description
- `POST /api/workflows` - Create workflow
- `GET /api/workflows` - List workflows
- `POST /api/execute/{workflow_id}` - Execute workflow

## Environment Variables

Set these as Secrets in your HuggingFace Space:

- `GROQ_API_KEY` - Your Groq API key for LLM calls
- `OPENROUTER_API_KEY` - (Optional) OpenRouter API key
- `GEMINI_API_KEY` - (Optional) Google Gemini API key

## Usage

```bash
curl -X POST https://YOUR-SPACE.hf.space/api/planner/generate \
  -H "Content-Type: application/json" \
  -d '{"task": "Monitor Bitcoin price and alert when it drops 5%"}'
```