feat: provider Cerebras (free tier generoso) na hierarquia apos o local

.env.example

@@ -5,6 +5,7 @@ AI_MODEL=
 
 OPENROUTER_API_KEY=
 GROQ_API_KEY=
+CEREBRAS_API_KEY=
 DEEPSEEK_API_KEY=
 MISTRAL_API_KEY=
 GEMINI_API_KEY=

README.md

@@ -22,8 +22,11 @@ A anotação @spaces.GPU está configurada para suportar inferência rápida.
 
 ## Hierarquia de provedores (fallback)
 
-1. Llama local (ZeroGPU) → 2. OpenRouter → 3. Groq → 4. DeepSeek → 5. Mistral → 6. Gemini.
+1. Llama local (ZeroGPU) → 2. Cerebras → 3. OpenRouter → 4. Groq → 5. DeepSeek → 6. Mistral → 7. Gemini.
 Cada nível que falha cai para o seguinte; `AI_PROVIDER` força um específico primeiro.
+Provedores sem chave são saltados. Cerebras tem free tier generoso (1M tokens/dia,
+sem cartão; contexto 8K no free): cria a chave em cloud.cerebras.ai e define
+`CEREBRAS_API_KEY`. Modelos OpenRouter com `:free` também valem como degrau gratuito.
 O Llama local (`local_llm.py`, `NousResearch/Meta-Llama-3-8B-Instruct` por defeito,
 LoRA opcional via `LORA_ADAPTER_PATH` — pasta local ou id do Hub, ex. `user/meu-lora`,
 com download automático e confirmação de adaptadores ativos no log) é carregado

ai_engine.py

@@ -163,7 +163,7 @@ class AIEngine:
 
         # Nivel de Hierarquia (Fallback)
         # 1. Llama Local (ZeroGPU) -> 2. OpenRouter -> 3. Groq -> 4. DeepSeek -> 5. Gemini
-        ordem_provedores = ["local_llama", "openrouter", "groq", "deepseek", "mistral", "gemini"]
+        ordem_provedores = ["local_llama", "cerebras", "openrouter", "groq", "deepseek", "mistral", "gemini"]
         
         forced_provider = Config.AI_PROVIDER
         if forced_provider and forced_provider != "auto":
@@ -179,6 +179,7 @@ class AIEngine:
                 # Saltar provedores se a respectiva chave de seguranca nao existir
                 if provider == "openrouter" and not Config.OPENROUTER_API_KEY: continue
                 if provider == "groq" and not Config.GROQ_API_KEY: continue
+                if provider == "cerebras" and not Config.CEREBRAS_API_KEY: continue
                 if provider == "deepseek" and not Config.DEEPSEEK_API_KEY: continue
                 if provider == "mistral" and not Config.MISTRAL_API_KEY: continue
                 if provider == "gemini" and not Config.GEMINI_API_KEY: continue
@@ -273,6 +274,11 @@ class AIEngine:
                 "Authorization": f"Bearer {Config.GROQ_API_KEY}",
                 "Content-Type": "application/json",
             }
+        if provider == "cerebras":
+            return "https://api.cerebras.ai/v1/chat/completions", {
+                "Authorization": f"Bearer {Config.CEREBRAS_API_KEY}",
+                "Content-Type": "application/json",
+            }
         if provider == "deepseek":
             return "https://api.deepseek.com/chat/completions", {
                 "Authorization": f"Bearer {Config.DEEPSEEK_API_KEY}",

config.py

@@ -12,6 +12,7 @@ class Config:
     MISTRAL_API_KEY = os.getenv("MISTRAL_API_KEY", "").strip()
     GEMINI_API_KEY = os.getenv("GEMINI_API_KEY", "").strip()
     GROQ_API_KEY = os.getenv("GROQ_API_KEY", "").strip()
+    CEREBRAS_API_KEY = os.getenv("CEREBRAS_API_KEY", "").strip()
 
     API_AUTH_TOKEN = os.getenv("API_AUTH_TOKEN", "").strip()
 
@@ -134,6 +135,7 @@ Notas de preço
         "deepseek": "deepseek-chat",
         "mistral": "mistral-small-latest",
         "groq": "llama-3.3-70b-versatile",
+        "cerebras": "llama-3.3-70b",
         "gemini": "gemini-2.0-flash",
     }
 
@@ -145,6 +147,8 @@ Notas de preço
             return "openrouter"
         if cls.GROQ_API_KEY:
             return "groq"
+        if cls.CEREBRAS_API_KEY:
+            return "cerebras"
         if cls.DEEPSEEK_API_KEY:
             return "deepseek"
         if cls.MISTRAL_API_KEY: