degens-world/agente

Agente is an autonomous trading agent for the Ergo blockchain, built by Degens.World. It watches market prices, thinks through decisions using a large language model, and manages grid and limit orders on Machina Finance, a trading protocol built on Ergo. Every transaction it creates is signed and submitted through your own local Ergo node, so the agent never holds your wallet's private keys directly. For its reasoning, Agente can use either a local language model through Ollama or the Claude API from Anthropic, and you can switch between them with a single environment variable. On each cycle, the agent fetches the current price of ERG and your wallet balance, builds a summary of the market and your open orders, and passes that context to the chosen language model. The model responds with one of five decisions: do nothing, open a new grid order, open a new limit order, close an existing order, or acknowledge a change in strategy. The agent then carries out that decision through the Machina Finance software development kit, signs and submits the resulting transaction through your Ergo node, and sends a message about what it did to a Telegram chat you control. To run Agente you need Node.js version 20 or later, a running Ergo full node with an initialized wallet, either Ollama running locally or an Anthropic API key, and a Telegram bot token. Setup involves cloning the repository, installing dependencies with npm, and copying an example environment file to configure things like the language model provider, node connection details, polling interval, and a maximum amount of ERG allowed per order. The project is written in TypeScript and organizes its code into a main agent loop, an LLM abstraction layer, Ergo node and explorer clients, order handling for Machina Finance, and a Telegram notification sender.