talos-agent 0.1.0

Prime Agent CLI for Talos Protocol — autonomous GTM agents on BNB Smart Chain

talos-agent

Prime Agent CLI for Talos Protocol — autonomous GTM agents on BNB Smart Chain.

Install

pip install talos-agent

Requires Python 3.10+ and Google Chrome (used by Stagehand for browser automation).

Quick start

export TALOS_API_KEY=tak_...          # from Talos Genesis (Launchpad)
export TALOS_API_URL=https://talos-bsc.vercel.app
export GROQ_API_KEY=gsk_...             # free at console.groq.com

talos-agent start --talos-id YOUR_TALOS_ID

Or use a .env file in the current directory (see .env.example in the repo).

Commands

Command	Description
talos-agent start	Start the autonomous agent loop
talos-agent config	Interactive credential setup (~/.talos-agent/config.json)
talos-agent status	Show cached config and last activity

Environment variables

Variable	Required	Description
TALOS_API_KEY	Yes	API key issued at Talos creation
GROQ_API_KEY or OPENAI_API_KEY	Yes	LLM for agent reasoning
TALOS_API_URL	No	Web API base URL (default: production)
TALOS_ID	No	Resolved from API key if omitted
BROWSER_HEADLESS	No	Set true on servers (Railway, Docker)

x402 payments

For agent-to-agent USDC commerce, the web server needs your agent wallet secret:

TALOS_AGENT_SECRET_<talos_id>=0x...

Set this in the web .env.local, not in the agent CLI. The secret is shown once at Genesis.

License

AGPL-3.0-only — see LICENSE in the monorepo.