Delete INSTRUCTIONS.md

INSTRUCTIONS.md

@@ -1,170 +0,0 @@
-# 📘 Para.AI RAG Cluster - Instructions
-
-## 🎯 Objetivo
-
-Deploy de micro-cluster RAG no Hugging Face Spaces (free tier) para indexar ~300k jurisprudências do TJPR.
-
-## 📋 Arquivos do Projeto
-
-| Arquivo | Função |
-|---------|---------|
-| `config.yaml` | Configuração (EDITE AQUI!) |
-| `Dockerfile` | Container Docker |
-| `entrypoint.sh` | Script de inicialização |
-| `requirements.txt` | Dependências Python |
-| `filter_fields.py` | Filtrar campos JSONL |
-| `rag_builder.py` | Construir ChromaDB |
-| `query_engine.py` | Engine de busca |
-| `app.py` | FastAPI REST API |
-| `README.md` | Documentação básica |
-| `.gitignore` | Arquivos ignorados |
-
-## 🚀 Deploy Step-by-Step
-
-### 1. Preparar Configuração
-
-Editar `config.yaml`:
-
-```yaml
-cluster_id: "RAG-0301"      # Seu ID único
-chunk_start: 301            # Primeiro chunk
-chunk_end: 600              # Último chunk (300 chunks = ~300k registros)
-github_repo: "https://github.com/SEU-USUARIO/para-ai-data.git"
-```
-
-### 2. Criar Space no HF
-
-```bash
-# Login
-huggingface-cli login
-
-# Criar Space
-huggingface-cli repo create para-ai-rag-0301 --type space --space_sdk docker
-```
-
-### 3. Fazer Upload
-
-```bash
-cd hf_space_rag_example
-
-# Inicializar Git
-git init
-git remote add origin https://huggingface.co/spaces/SEU-USUARIO/para-ai-rag-0301
-
-# Commit
-git add .
-git commit -m "Initial deployment"
-
-# Push
-git push origin main
-```
-
-### 4. Aguardar Build
-
-- Acesse: https://huggingface.co/spaces/SEU-USUARIO/para-ai-rag-0301
-- Status: Building (5-10 min) → Running (5-10 min) → Ready ✅
-
-### 5. Testar
-
-```bash
-# Info do cluster
-curl https://SEU-USUARIO-para-ai-rag-0301.hf.space/cluster/info
-
-# Busca semântica
-curl -X POST https://SEU-USUARIO-para-ai-rag-0301.hf.space/search/embedding \
-  -H "Content-Type: application/json" \
-  -d '{"query": "despejo falta pagamento", "top_k": 5}'
-```
-
-## 🌐 Arquitetura Distribuída
-
-Para cobrir todos os 4.5M registros, crie 15 Spaces:
-
-| Space | Chunks | Config |
-|-------|--------|--------|
-| para-ai-rag-0001 | 1-300 | chunk_start: 1, chunk_end: 300 |
-| para-ai-rag-0301 | 301-600 | chunk_start: 301, chunk_end: 600 |
-| para-ai-rag-0601 | 601-900 | chunk_start: 601, chunk_end: 900 |
-| ... | ... | ... |
-| para-ai-rag-4201 | 4201-4500 | chunk_start: 4201, chunk_end: 4500 |
-
-**Script de deploy automático** (bash):
-
-```bash
-#!/bin/bash
-for START in 1 301 601 901 1201 1501 1801 2101 2401 2701 3001 3301 3601 3901 4201; do
-  END=$((START + 299))
-  SPACE_NAME="para-ai-rag-$(printf "%04d" $START)"
-
-  huggingface-cli repo create $SPACE_NAME --type space --space_sdk docker
-  git clone https://huggingface.co/spaces/SEU-USUARIO/$SPACE_NAME
-  cd $SPACE_NAME
-
-  # Copiar template e atualizar config
-  cp -r ../hf_space_rag_example/* .
-  sed -i "s/chunk_start: .*/chunk_start: $START/" config.yaml
-  sed -i "s/chunk_end: .*/chunk_end: $END/" config.yaml
-
-  git add .
-  git commit -m "Deploy cluster $START-$END"
-  git push
-  cd ..
-done
-```
-
-## 🔧 Customização
-
-### Adicionar Mais Campos
-
-Em `config.yaml`:
-
-```yaml
-campos_filter:
-  - id
-  - ementa
-  - data_decisao     # Adicionar
-  - relator          # Adicionar
-```
-
-### Trocar Modelo de Embedding
-
-```yaml
-# Opção 1: Mais leve (padrão)
-embedding_model: "sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2"
-embedding_dim: 384
-
-# Opção 2: Melhor qualidade
-embedding_model: "sentence-transformers/paraphrase-multilingual-mpnet-base-v2"
-embedding_dim: 768
-```
-
-## 🐛 Troubleshooting
-
-### Build muito lento
-- Verificar se sparse checkout está funcionando
-- Reduzir número de chunks temporariamente
-
-### Out of Memory
-- Usar modelo menor: `all-MiniLM-L6-v2`
-- Reduzir `embedding_batch_size: 32`
-- Diminuir intervalo de chunks
-
-### API retorna 503
-- Ver logs do Space no HF
-- Verificar se ChromaDB foi construído
-
-## 📊 Recursos Utilizados
-
-| Recurso | Usado | Disponível (Free) |
-|---------|-------|-------------------|
-| RAM | ~2GB | 16GB ✅ |
-| Disco | ~2.6GB | 50GB ✅ |
-| CPU | 1 core | 2 cores ✅ |
-
-## ⚖️ Sobre Para.AI
-
-Projeto open-source para democratizar o acesso à justiça no Paraná usando IA.
-
-🐝 **InJustiça não para o Paraná!**
-
-📧 github.com/caarleexx/para-ai