About Traxo
Traxo is an open-source agent that runs your e-commerce from inside Claude. When an order comes in it quotes carriers, picks the best one (and explains why), confirms risky cash-on-delivery orders over WhatsApp, creates the shipping label, writes it back to your store, tracks the parcel and handles delivery incidents. It also audits your store, builds ads from your own UGC videos and product photos, tells you which ad brought which sale, looks after your customers with their consent, and shows you what the agent did and what it cost. Everything that happens in your business lives in one place, with an agent you can ask.
- Yours: runs on your computer or your own cloud. Your data and keys never leave your server.
- Honest: what can't be measured shows as
N/A; anything that spends, publishes or deletes waits for your yes; campaigns are born paused.
- Global by design, Colombia first: the first fully supported market is Colombia (COP, DANE codes, Colombian carriers). The architecture is built so anyone can add their country: see Supported markets.
- Community-owned: MIT, no paid service of ours in the middle. Contribute, open an issue, or tell us how you use it.
Screenshots
Sample data from the built-in demo mode (the panel is in Spanish today).
Install with the guided wizard
You need Claude Code, Node 24 and git. The wizard does the rest.
claude plugin marketplace add Hainrixz/traxo-agente
claude plugin install traxo@traxo
Open claude and type:
/traxo:instalar
The wizard asks you questions and handles everything step by step, verifying each one:
- Clones the project, installs dependencies and builds the panel.
- Asks where to run it (your computer or a cloud like Railway), which platform your store uses (Shopify, Tiendanube, WooCommerce), who you ship with, your login email, your dispatch address and what else to turn on (WhatsApp/Instagram/Messenger through Zernio, prepayment with Wompi, AI with your own Claude key).
- Creates your
.env with the non-secret values, generates the internal secrets for you (sessions, /mcp token, admin password) and tells you where to get each third-party key. You paste those into .env yourself: they never go through the chat or reach the model.
- Runs
pnpm doctor, which checks everything (✓ / ✗ / –) and tests connections without ever printing a value.
- Starts it locally, or deploys it to Railway (project, Postgres, variables, volume and domain) with your confirmation.
- Gives you the webhook URLs for your store, Envia.com, Zernio and Wompi, connects Claude to Traxo's tools and leaves you ready for day one.
If something fails, the wizard explains it and fixes it before moving on. You can re-run /traxo:instalar any time: it never overwrites what you already configured. The wizard talks in Spanish today; English is on the roadmap.
git clone https://github.com/Hainrixz/traxo-agente.git && cd traxo-agente
corepack enable && pnpm install
pnpm build
node scripts/setup.mjs --answers '{"adminEmail":"[email protected]","platform":"shopify","storeDomain":"yourstore.myshopify.com","envia":true}'
# open .env and paste your keys (the pending list is printed by the command above)
pnpm doctor # checks that everything is fine
pnpm start # http://localhost:8787 (sign in with the email and password in your .env)
claude mcp add --scope user traxo -- pnpm --silent --dir "$PWD" exec tsx apps/worker/src/mcp-stdio.ts
node scripts/setup.mjs (or pnpm configurar) and pnpm doctor never print a variable's value. Templates for every variable are in .env.example.
What's in the panel
The left menu has what you use daily. What you configure lives in your profile (bottom left): settings, autonomy limits, connections, theme and sign out. The panel is in Spanish today; the translation layer is the first step of the roadmap.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
