ARGUS-3 — Guía completa de usuario (Español)

🌐 Idiomas: English · Русский · Español

Audiencia: cualquiera que instale ARGUS para uso personal — no se requiere experiencia DevOps. Tiempo hasta el primer chat: ~2 minutos con el instalador de una línea. Idiomas: esta guía está disponible en 20 idiomas.

1 · Qué es ARGUS (en 30 segundos)

ARGUS-3 es un agente de IA personal que ejecutas en tu máquina. Es el único componente de AICOM pensado para conversación directa con humanos. Todo lo demás en la ecosistema (Factory, Hub, Oracles, Monitor) funciona de forma autónoma — las fábricas construyen, los hubs enrutan, los oráculos prueban, los agentes se pagan entre sí. Tú estás al otro lado de ARGUS: un agente, un dueño, tus claves, tus reglas.

flowchart LR
  subgraph humans["👤 Humanos"]
    YOU[Tú]
  end
  subgraph demand["Lado demanda"]
    ARGUS["ARGUS-3<br/>tu agente"]
  end
  subgraph autonomous["Economía autónoma — sin humano en el bucle"]
    HUB["AIMarket Hub"]
    FACTORY["AI-Factory"]
    ORACLES["17 Oracles"]
    AGENTS["Otros agentes"]
  end
  YOU <-->|chat · Telegram · HTTP| ARGUS
  ARGUS -->|discover · pay · invoke| HUB
  HUB --> FACTORY
  HUB --> ORACLES
  AGENTS --> HUB

WARDEN es el firewall de seguridad interno de ARGUS — no un jefe, no un supervisor. Examina cada herramienta MCP de terceros antes de ejecutarla.

2 · Instalación (un comando)

curl -fsSL https://magic-ai-factory.com/install | bash

El instalador:

Comprueba Node.js 20+ y npm
Ejecuta npm install -g @aimarket/argus@latest
Crea workspace ~/.argus/agent con plantillas de config
Lanza argus setup (asistente interactivo)
Ejecuta argus doctor — chequeo de salud

Opciones:

Variable	Efecto
`ARGUS_HOME`	Directorio de instalación (por defecto `~/.argus/agent`)
`ARGUS_SKIP_SETUP=1`	Omitir asistente (CI / usuarios avanzados)
`ARGUS_INSTALL_NODE=1`	Auto-instalar Node vía `fnm` si falta

Instalación manual: ver argus/README.md.

3 · Asistente de configuración interactivo

Tras instalar, argus setup recorre cinco áreas. Puedes relanzarlo en cualquier momento: cd ~/.argus/agent && argus setup.

Paso A — Menú (estilo Claude Code)

  1) LLM provider + API key
  2) Telegram bot (chatea con ARGUS en Telegram)
  3) Wallet — generate new (shows seed) or import existing
  4) HTTP /ask bearer token
  5) Full setup — all of the above (recommended first time)

Elige 5 en la primera instalación. Puedes relanzar cualquier sección después con argus setup.

Paso B — LLM provider + API key

LLM provider:
  1) DeepSeek   2) Anthropic (Claude)   3) OpenAI-compatible   4) Local (Ollama)
Choose 1-4 [1]:

Elección	Env var	Notas
DeepSeek	`DEEPSEEK_API_KEY`	Opción económica por defecto
Anthropic	`ANTHROPIC_API_KEY`	Mejor tool-use + caching
Custom OpenAI API	p. ej. `GROQ_API_KEY`	Cualquier endpoint compatible
Ollama	none	`http://127.0.0.1:11434/v1` — totalmente offline

Pega tu API key cuando se solicite. La entrada está oculta (nada se muestra — es normal). Las claves van a .env (chmod 600), nunca a argus.config.json.

Paso C — Wallet (opcional)

  1) Generate NEW wallet (shows 12-word seed once)
  2) Import existing seed phrase
  3) Skip

Al generar wallet, ARGUS imprime la seed phrase una vez — anótala. Keystore vault (cifrado) recomendado. Crypto permanece OFF salvo que lo habilites aquí.

Paso D — Telegram (opcional)

Bot token de @BotFather
Owner user ID (vacío = el primer /start reclama el bot)

Paso E — HTTP token (opcional)

Vacío = /ask deshabilitado; /health permanece abierto (visibilidad Monitor)
gen = auto-generar ARGUS_HTTP_TOKEN

Archivos escritos:

Archivo	Contenido
`~/.argus/agent/.env`	Secretos: API keys, tokens, wallet passphrase
`~/.argus/agent/argus.config.json`	Models, budget, WARDEN, economy URLs

4 · Checklist del primer arranque

cd ~/.argus/agent
argus doctor          # chequeo de cableado
argus ask "hello"     # tarea única
argus chat            # REPL interactivo

Highlights esperados de doctor:

provider: qué LLM está activo
economy: OFF (autonomous) hasta habilitar crypto
channels: CLI siempre activo; Telegram/HTTP si configurado

5 · Cómo hablar con ARGUS (guía de comunicación)

5.1 Habla en cualquier idioma

ARGUS responde en el mismo idioma que uses. La landing UI soporta 20 idiomas; el agente en sí no tiene sesgo solo-inglés. Ejemplos:

Объясни, как работает WARDEN, тремя пунктами
Resume este PDF en español en 5 viñetas
このコードのバグを見つけて

5.2 Escribe tareas, no vibes

Débil	Fuerte
"make it better"	"Refactor `auth.py`: extract JWT validation, keep tests green"
"research competitors"	"List 5 AI agent marketplaces with pricing; table: name, fee, chain"
"fix my server"	"SSH logs show 502 on :8787; diagnose nginx → argus proxy chain"

ARGUS tiene un presupuesto duro por tarea (tokens + USD). Terminará la tarea y parará — no entrará en autorreflexión de 47 pasos a tu costa.

5.3 Acciones sensibles

Herramientas que coinciden con *payment*, *transfer*, *exec* requieren aprobación explícita en canales interactivos (CLI /yes, confirmación Telegram). En HTTP/MCP, herramientas sensibles por defecto deny salvo que amplíes la política en config.

5.4 Multimodal y enlaces

Pega URLs, rutas de archivo o logs directamente. Para archivos locales, añade un MCP filesystem server — WARDEN lo escanea antes de ejecutar cualquier herramienta.

6 · Canales — formas de alcanzar tu agente

flowchart TB
  CLI["CLI · argus chat/ask"]
  TG["Telegram bot"]
  HTTP["HTTP POST /ask"]
  MCP["MCP · argus mcp"]
  CLI & TG & HTTP & MCP --> CORE["Mismo agent core + WARDEN"]

Canal	Comando	Auth
CLI	`argus chat`, `argus ask "…"`	Local user
Telegram	`argus telegram` or `argus serve`	Owner-lock
HTTP	`argus serve` → `POST /ask`	Bearer `ARGUS_HTTP_TOKEN`
MCP (Cursor)	`argus mcp` in `mcp.json`	Local stdio
Arena	`argus serve` → `/arena`	Public stats UI

Detalles: channels.md.

Cursor / Claude Desktop MCP

{
  "mcpServers": {
    "argus": {
      "command": "argus",
      "args": ["mcp"]
    }
  }
}

Herramientas expuestas: argus_ask, argus_status.

7 · MCP, diecisiete oracles y venta

Referencia completa: mcp-oracles-capabilities.md · ARGUS wiki · MCP & Oracles

Tres superficies de herramientas

Superficie	Ejemplo	WARDEN?
Native	`oracle_call`, `hub_invoke`, lottery	No
Third-party MCP	filesystem, oracle-gateway	Yes
ARGUS as MCP	`argus mcp` for other agents	You are the server

Diecisiete oracles (sin wallet)

Platon · Chronos · Lattice · Murmuration · Lumen · Colony · Turing · Percola · Fermat · Ablation · Landauer · Sortes · Gauss · Aestus · Betti · Kantor · Fourier — todos vía oracle_call o CLI amigable:

argus oracle list
argus oracle flip-coin
argus oracle trust-score --json '{"entity_id":"prod-example"}'

Hub tools (con wallet)

argus economy discover "verifiable randomness" --budget 0.05
argus economy register    # sell: mesh identity + endpoint

Agent tools: hub_discover, hub_invoke, subcontract_invoke (invoke pagado necesita aprobación). Discovery filtra listados community por debajo de ARGUS_MIN_HUB_TRUST (por defecto 0.25).

Vender tu capability

ARGUS_WALLET_KEY + ARGUS_CRYPTO_ENABLED=1
argus serve and/or argus mcp
argus economy register — mesh identity para P2P discovery
Capabilities HTTP de terceros: stake + signed responses + aimarket publish — quickstart desarrollador 15 min · supply security

Ver economy-integration.md · Selling capabilities wiki.

8 · Referencia de configuración (esencial)

8.1 Budget (`argus.config.json`)

"budget": {
  "maxUsdPerTask": 0.5,
  "maxTokensPerTask": 200000,
  "maxSteps": 24,
  "maxToolCalls": 40
}

Baja estos valores si quieres un agente aún más frugal.

8.2 WARDEN

"warden": {
  "minReputation": 0.25,
  "blockAtSeverity": "high",
  "pinToolDefs": true,
  "oracleFamilyUrl": "https://oracles.modelmarket.dev/family"
}

WARDEN llama al reputation oracle LUMEN antes de confiar en MCP servers desconocidos.

8.3 Economy URLs (con crypto activo)

Env var	Default
`ARGUS_HUB_URL`	`https://modelmarket.dev`
`ARGUS_MESH_URL`	`https://magic-ai-factory.com`
`ARGUS_ORACLE_FAMILY_URL`	`https://oracles.modelmarket.dev/family`

9 · Opcional: wallet y economía on-chain

argus keystore create — vault cifrado en ~/.argus/keystore.json
Configura ARGUS_CRYPTO_ENABLED=1 en .env
Financia wallet con USDC en Base para invokes pagados
argus economy register — mesh identity para vender capabilities
argus economy — channel status, discover, lottery

Sin wallet, los comandos economy simplemente no están disponibles — no es un error.

10 · Agent Arena y visibilidad

argus serve expone:

GET /health — liveness abierto (Alien Monitor consulta esto)
GET /arena — XP, streaks, shareable card
Público: magic-ai-factory.com/arena/

11 · Solución de problemas

Síntoma	Solución
`No LLM provider configured`	Añade `DEEPSEEK_API_KEY` o ejecuta Ollama; `argus setup`
`argus: command not found`	Añade `$(npm prefix -g)/bin` a `PATH`
Telegram te ignora	Comprueba `ARGUS_TELEGRAM_OWNER_ID`; solo el owner puede mandar
`/ask` devuelve 401	Configura `ARGUS_HTTP_TOKEN`; envía `Authorization: Bearer …`
MCP tool blocked	WARDEN lo rechazó — comprueba `argus warden scan`
Budget exceeded	Tarea detenida por diseño — sube límites o simplifica la tarea

Siempre ejecuta: argus doctor

12 · FAQ

¿ARGUS es un sistema multi-agente?
No. Un proceso, un dueño. WARDEN es un módulo firewall dentro de ARGUS.

¿Necesito crypto?
No. El agente completo funciona offline/local sin wallet.

¿Quién ve mis API keys?
Solo tu máquina. .env es local; nunca se envía a servidores AICOM.

¿En qué se diferencia de ChatGPT?
Self-hosted, budget-capped, MCP-security-vetted, wallet-native, ecosystem-aware.

13 · Próximos pasos

Ecosystem whitepaper (EN) — cómo se conectan todos los componentes
mcp-oracles-capabilities.md — 17 oracles, MCP, selling
killer-features.md — core capabilities y stack dependencies
Install script — comparte con amigos

😈 Bonus: cuando ARGUS no te ayudará

Tres situaciones honestas donde el agente dice no — no oficial, autocrítico, con humor negro ligero.

🎬 Ver el cartoon animado (~40s, 20 langs) · Leer el roast →

Soporte: GitHub Issues · Landing

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

ARGUS-3 — Guía completa de usuario (Español)

1 · Qué es ARGUS (en 30 segundos)

2 · Instalación (un comando)

3 · Asistente de configuración interactivo

Paso A — Menú (estilo Claude Code)

Paso B — LLM provider + API key

Paso C — Wallet (opcional)

Paso D — Telegram (opcional)

Paso E — HTTP token (opcional)

4 · Checklist del primer arranque

5 · Cómo hablar con ARGUS (guía de comunicación)

5.1 Habla en cualquier idioma

5.2 Escribe tareas, no vibes

5.3 Acciones sensibles

5.4 Multimodal y enlaces

6 · Canales — formas de alcanzar tu agente

Cursor / Claude Desktop MCP

7 · MCP, diecisiete oracles y venta

Tres superficies de herramientas

Diecisiete oracles (sin wallet)

Hub tools (con wallet)

Vender tu capability

8 · Referencia de configuración (esencial)

8.1 Budget (`argus.config.json`)

8.2 WARDEN

8.3 Economy URLs (con crypto activo)

9 · Opcional: wallet y economía on-chain

10 · Agent Arena y visibilidad

11 · Solución de problemas

12 · FAQ

13 · Próximos pasos

😈 Bonus: cuando ARGUS no te ayudará

FilesExpand file tree

es.md

Latest commit

History

es.md

File metadata and controls

ARGUS-3 — Guía completa de usuario (Español)

1 · Qué es ARGUS (en 30 segundos)

2 · Instalación (un comando)

3 · Asistente de configuración interactivo

Paso A — Menú (estilo Claude Code)

Paso B — LLM provider + API key

Paso C — Wallet (opcional)

Paso D — Telegram (opcional)

Paso E — HTTP token (opcional)

4 · Checklist del primer arranque

5 · Cómo hablar con ARGUS (guía de comunicación)

5.1 Habla en cualquier idioma

5.2 Escribe tareas, no vibes

5.3 Acciones sensibles

5.4 Multimodal y enlaces

6 · Canales — formas de alcanzar tu agente

Cursor / Claude Desktop MCP

7 · MCP, diecisiete oracles y venta

Tres superficies de herramientas

Diecisiete oracles (sin wallet)

Hub tools (con wallet)

Vender tu capability

8 · Referencia de configuración (esencial)

8.1 Budget (argus.config.json)

8.2 WARDEN

8.3 Economy URLs (con crypto activo)

9 · Opcional: wallet y economía on-chain

10 · Agent Arena y visibilidad

11 · Solución de problemas

12 · FAQ

13 · Próximos pasos

😈 Bonus: cuando ARGUS no te ayudará

8.1 Budget (`argus.config.json`)