# Talos

> A self-hosted, vertical Ethereum agent. Daemon plus thin clients. Curated DeFi tools. Daily-fresh ecosystem knowledge. Bring your own keys.

Talos is an open-source agent for working with Ethereum. It runs locally as `talosd`, exposes thin clients (CLI REPL, Telegram bot, MCP server), and routes every chain-mutating tool call through KeeperHub for an auditable trail. Read-only calls bypass the audit hop.

Install: `npx talos init`
Repo: https://github.com/Allen-Saji/talos
License: MIT

## Get started

- [First run](https://talos.allensaji.dev/docs/get-started/first-run): Start the daemon, open the REPL, ask Talos something.
- [talos init walkthrough](https://talos.allensaji.dev/docs/get-started/init): The interactive wizard, step by step.
- [Installation](https://talos.allensaji.dev/docs/get-started/install): Install Talos from source. Node 22+, pnpm 9+, an OpenAI API key.
- [Overview](https://talos.allensaji.dev/docs/get-started/overview): What Talos is, what it does, and how it fits into your stack.

## Architecture

- [Daemon + thin clients](https://talos.allensaji.dev/docs/architecture/daemon): Why talosd owns the world and clients are dumb.
- [KeeperHub middleware](https://talos.allensaji.dev/docs/architecture/keeperhub): Audit-by-default execution for every chain-mutating tool.
- [Layer cake](https://talos.allensaji.dev/docs/architecture/layer-cake): How talosd, the runtime, persistence, the wallet, and the hot MCP host fit together.
- [Three-tier memory](https://talos.allensaji.dev/docs/architecture/memory): Hot, warm, and cold recall — how Talos remembers across runs and threads.

## Channels

- [CLI REPL](https://talos.allensaji.dev/docs/channels/cli): A thin WebSocket REPL over talosd. ^C aborts, ^D exits.
- [MCP server](https://talos.allensaji.dev/docs/channels/mcp): Drop Talos into Claude Desktop, Cursor, or OpenClaw as an MCP server.
- [Telegram](https://talos.allensaji.dev/docs/channels/telegram): Talk to Talos from your phone via a long-polling Telegram bot.

## Tools

- [Aave V3](https://talos.allensaji.dev/docs/tools/aave): Custom MCP source for Aave V3 on Sepolia. Supply, borrow, repay, withdraw, account-data reads.
- [AgentKit](https://talos.allensaji.dev/docs/tools/agentkit): Coinbase AgentKit cherry-pick — wallet primitives, Pyth, Compound, Morpho, and more.
- [Blockscout](https://talos.allensaji.dev/docs/tools/blockscout): Multi-chain block, contract, and tx reads via the hosted Blockscout MCP.
- [EVM-MCP](https://talos.allensaji.dev/docs/tools/evm-mcp): Generic EVM RPC operations via mcpdotdirect/evm-mcp — ENS, ERC-20, ERC-721.
- [Li.Fi](https://talos.allensaji.dev/docs/tools/lifi): Cross-chain bridges and quotes via the Li.Fi SDK.
- [Uniswap V3](https://talos.allensaji.dev/docs/tools/uniswap): Custom MCP source for Uniswap V3 on Sepolia. Quote, approve, exact-input swap.

## Reference

- [CLI commands](https://talos.allensaji.dev/docs/reference/cli): Every command the talos binary exposes.
- [Config files](https://talos.allensaji.dev/docs/reference/config): channels.yaml and the JSON files in ~/.config/talos/.
- [Environment variables](https://talos.allensaji.dev/docs/reference/env): Every env var Talos reads, what it does, and where it's set.

## Self-hosting

- [Doctor diagnostics](https://talos.allensaji.dev/docs/self-hosting/doctor): talos doctor prints what's wrong and how to fix it.
- [launchd / systemd](https://talos.allensaji.dev/docs/self-hosting/service): Run talosd as a user-level service.

## Embedding Talos

- [Embedding Talos](https://talos.allensaji.dev/docs/embedding/overview): Use Talos as an MCP server inside another agent host. Tools, semantics, threading.

## Top level

- [Welcome](https://talos.allensaji.dev/docs): Talos docs — install, embed, configure, extend.