Quickstart
Prerequisitos
Rust (cargo), Bun, y un endpoint LLM compatible con OpenAI — local (llama.cpp / Ollama / LM Studio) o una key gratuita de OpenRouter.
Clonar y arrancar
git clone https://github.com/Javiju555/blazer.git && cd blazer
cp server.example.toml blazer-server.toml
cd web && bun install && bun run build && cd ..
cargo build --release -p blazer-server
./target/release/blazer-server # → http://localhost:8080Terminal UI (opcional)
cargo build --release -p blazer-client
cp client.example.toml blazer-client.toml
./target/release/blazerArquitectura
blazer-server
Nucleo del agente: loop, tools, memoria, skills. Sirve la web SPA y expone /ws/chat.
web (SvelteKit)
Chat + canvas CodeMirror. SPA con adapter-static.
blazer (TUI)
Cliente terminal. Modo direct embebe el core; modo server habla con blazer-server.
Providers
Endpoints OpenAI y Anthropic soportados nativamente. Configurado en [providers.*].
Cómo aprende
Blazer no solo llama a un modelo — acumula conocimiento durable en archivos que puedes leer, editar y hacer git diff.
Memoria
Por capas: user, project, workspace, global. Indice en system prompt; cuerpos bajo demanda.
Skills
Auto-crear después de éxitos, puntuar por outcome real, podar fracasos. Teacher→student.
Loop cerrado
Auto-crear → refinar → puntuar → podar. Todo en archivos Markdown legibles.
Providers
Endpoints OpenAI y Anthropic soportados nativamente. Local o cloud, tu eliges.
Local
llama.cpp, Ollama, LM Studio. Sin coste, sin salir de tu máquina. Compatible con Qwen, Llama, Gemma, etc.
OpenRouter
Acceso a modelos cloud. Hay key gratuita para probar. OpenAI-compatible.
OpenAI
Protocolo /v1/chat/completions. OpenRouter, MiniMax, Groq, xAI, cualquier API compatible.
Anthropic
Protocolo /v1/messages nativo. Claude directo. Auto-detectado via models.dev.
MiniMax / otros
Cualquier API compatible con OpenAI funciona. Configura base_url y api_key.
Configuracion
blazer-server.toml
[server] host/puerto/web_dir · [providers.*] · [storage] dirs · [agent] comportamiento. Secretos via api_key_env o ~/.blazer/auth.json.
blazer-client.toml
connection.mode (direct/server/offline), tema, tools allowlists.
Estado
Funcionando
- Web (chat + canvas), sesiones, memoria
- blazer-server + /ws/chat
- Skills auto-mejorables
Bordes asperos
- Terminal UI
Construido, no conectado
- Web workspaces (jail bwrap)
Experimental
- Browser tools (off por defecto)
- Computer-use tools (off por defecto)