Welcome

Describe trading strategies in natural language. Generate executable Python. Backtest, analyze, and iteratively evolve with LLM-powered feedback.

pip install vibetrading

---

What is VibeTrading?

VibeTrading is an open-source trading framework where users describe strategies in natural language and AI agents generate, backtest, analyze, and evolve executable code.

How It Works

1. Describe — Tell the agent what you want in plain English.

2. Generate — AI produces framework-compatible strategy code with proper risk management.

3. Backtest — Run against historical data from any CCXT-supported exchange.

4. Analyze — An LLM evaluates backtest results: scores performance (1-10), finds weaknesses, suggests fixes.

5. Evolve — Repeat the loop. Each iteration feeds analysis back to the generator for continuous improvement.

Describe ──▶ Generate ──▶ Backtest ──▶ Analyze ──▶ Evolve
(prompt)      (LLM)        (engine)     (LLM)       (loop)
                ▲                                      │
                └──────────── feedback ────────────────┘

---

Quick Example

import vibetrading
import vibetrading.strategy
import vibetrading.backtest
import vibetrading.tools

# 1. Generate strategy from natural language
code = vibetrading.strategy.generate(
    "ETH mean reversion with Bollinger Bands, short when price hits upper band, "
    "long when price hits lower band, 5x leverage",
    model="gpt-4o",
)

# 2. Backtest
data = vibetrading.tools.download_data(["ETH"], exchange="binance", interval="1h")
results = vibetrading.backtest.run(code, interval="1h", data=data)

if results:
    metrics = results["metrics"]
    print(f"Return: {metrics['total_return']:.2%}")
    print(f"Sharpe: {metrics['sharpe_ratio']:.2f}")
    print(f"Max Drawdown: {metrics['max_drawdown']:.2%}")

# 3. Analyze with LLM
report = vibetrading.strategy.analyze(results, strategy_code=code)
print(f"Score: {report.score}/10")
print(report.suggestions)

# 4. Or evolve in one call
result = vibetrading.evolve("ETH mean reversion", iterations=3, model="gpt-4o")
print(f"Best score: {result.best_score}/10")

---

Package Modules

import vibetrading                # vibe decorator, evolve()
import vibetrading.strategy       # generate, validate & analyze strategies
import vibetrading.backtest       # backtest engine (BacktestEngine, run())
import vibetrading.evolution      # iterative strategy evolution
import vibetrading.tools          # data download & CSV loading

---

Links

• GitHub

• PyPI

• Community