gitwtfhub

wtf is evo-trader?

hhhmehmet/evo-trader — explained in plain English

Analysis updated 2026-07-25

6PythonAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A Python project that uses evolutionary ideas to improve cryptocurrency trading strategies on Coinbase. It runs simulated trading by default, evolving strategies over time through a natural selection process.

Mindmap

mindmap
  root((repo))
    What it does
      Evolves trading strategies
      Paper trading by default
      Five competing agents
    Tech stack
      Python
      Streamlit dashboard
      SQLite database
    Use cases
      Run fast demo mode
      Backtest with historical data
      View evolution dashboard
    Safety
      Live trading off by default
      Automated safety checklist
      Separate databases
    Audience
      Educational and experimental
      Crypto trading enthusiasts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run a fast demo to watch trading strategies evolve in under a minute.

REASON 2

Backtest evolving strategies against 30 days of real historical Coinbase data.

REASON 3

View a dashboard showing strategy rankings, agent performance, and family trees.

REASON 4

Experiment with evolutionary algorithms applied to financial markets.

What's in the stack?

PythonStreamlitSQLiteCoinbase API

How it stacks up

hhhmehmet/evo-traderaa2246740/ultimate-designaclark4life/home-depot-crawl
Stars666
LanguagePythonPythonPython
Last pushed2014-08-10
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity3/52/52/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Python setup and likely Coinbase API credentials for real market data, though a synthetic demo mode is available for quick testing.

Wtf does this do

{"i":0,"repo":"hhhmehmet/evo-trader","stars":6,"lang":"Python","ok":true,"char_count":1936,"text":"evo-trader is an experimental Python project that applies evolutionary ideas to cryptocurrency trading on Coinbase. It runs five independent agents, each following a different trading strategy, and lets them compete over 72-hour periods called generations. At the end of each generation, the best-performing agent's strategy is copied into five slightly modified descendants, which then compete in the next round. This cycle repeats indefinitely, so the system tries to improve its strategies over time through a process that resembles natural selection.\n\nThe project defaults to paper trading, meaning it uses real Coinbase market data but simulates the buys and sells without any real money changing hands. A fast demo mode lets you watch three generations run in under a minute using synthetic price data, which is useful for understanding how the evolution loop works without waiting days. Every generation's results are stored in a local SQLite database file, and if you stop and restart the program, it picks up the evolutionary history from where it left off.\n\nLive trading with real money is possible but deliberately hard to enable. The code can place real, authenticated orders on Coinbase, but it stays off by default. Turning it on requires setting two specific environment variables and passing an automated safety checklist that checks 11 things, including a loss limit, a kill switch, and mutation bounds. The project keeps live trading data in a separate database from paper trading data so the two never mix.\n\nA few supporting tools are included. A backtesting script fetches 30 days of real historical Coinbase price data and runs simulated generations against it in minutes, so you can evaluate strategies without waiting for real 72-hour windows. A dashboard built with Streamlit provides a read-only view of the database, showing per-generation rankings, individual agent performance, a family tree of how strategies evolved, and a log of agents that were eliminated.\n\nThe README is clear about the project's limitations: the included strategies are simple examples, backtest history showed net losses across 200 synthetic generations, and cryptocurrency trading carries substantial risk. The authors describe it as educational and experimental, not financial software, and they accept no responsibility for any losses from live trading."}

Yoink these prompts

Prompt 1
Using the evo-trader project, write a new trading strategy agent in Python that follows a mean reversion approach, compatible with the existing agent structure.
Prompt 2
Help me configure the two environment variables and understand the 11-point safety checklist required to enable live trading in evo-trader.
Prompt 3
Modify the evo-trader backtesting script to fetch 90 days of historical data instead of the default 30 days.
Prompt 4
Add a new metric to the Streamlit dashboard in evo-trader that displays the cumulative profit or loss across all generations.

Frequently asked questions

wtf is evo-trader?

A Python project that uses evolutionary ideas to improve cryptocurrency trading strategies on Coinbase. It runs simulated trading by default, evolving strategies over time through a natural selection process.

What language is evo-trader written in?

Mainly Python. The stack also includes Python, Streamlit, SQLite.

How hard is evo-trader to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is evo-trader for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.