README.md

---
title: Jade Code IDE API
emoji: 🟢
colorFrom: green
colorTo: gray
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit
---

# Jade Code IDE - Backend API

API backend para a Jade Code IDE, uma IDE web integrada com LLM.

## Arquitetura BYOK (Bring Your Own Key)

- **Segurança**: Cada usuário fornece sua própria API key do Groq
- A key é enviada via header `X-API-Key` em cada request
- O backend **nunca armazena** keys - só repassa pro LLM

## Endpoints

| Endpoint | Método | Descrição |
|----------|--------|-----------|
| `/` | GET | Health check |
| `/chat` | POST | Chat com o agente |
| `/run` | POST | Executa código Python |
| `/complete` | POST | Autocomplete via LLM |
| `/docs` | GET | Documentação OpenAPI |
| `/ui` | GET | Interface Gradio |

## Como usar

1. Obtenha uma API key do [Groq](https://console.groq.com/)
2. Use a IDE web em: `https://seu-usuario.github.io/jade-coder/`
3. Cole sua API key no campo indicado
4. Comece a codar!

## Desenvolvimento local

```bash
pip install -r requirements.txt
python app.py
```