Fizz

DeltaDefi strategy runner — Python backend + Next.js interface.

Prerequisites

macOS

# Homebrew (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# All dependencies in one line
brew install uv rust swig node

Tool	Why	Install
Homebrew	macOS package manager	see above
uv	Python package/project manager	brew install uv
Rust	Builds cardano-python-signing-module (deltadefi SDK dep)	brew install rust
SWIG	Generates Python bindings for Cardano signing	brew install swig
Node.js	Runs the Next.js interface	brew install node

Verify

uv --version       # >= 0.4
rustc --version     # >= 1.70
swig -version       # >= 4.0
node --version      # >= 18

Setup

# Install all dependencies (server + interface)
make install

Or individually:

make server-install      # Python deps (creates server/.venv)
make interface-install   # Node deps (creates interface/node_modules)

Environment

cp server/.env.example server/.env

Edit server/.env with your DeltaDefi credentials:

DELTADEFI_API_KEY=your-api-key
DELTADEFI_TRADING_PASSWORD=your-trading-password
DELTADEFI_NETWORK=preprod

Running

make server       # API server on http://localhost:8000
make interface    # Next.js on http://localhost:3000
make dev          # Both in parallel

Strategy Commands

make strategies   # List available strategies
make start-ma     # Start MA Crossover with defaults
make status-ma    # Check status
make stop-ma      # Stop

Project Structure

fizz/
├── server/           Python backend
│   ├── runner/       FastAPI server, executor, event bus
│   └── strategies/   Base framework + strategy plugins
├── interface/        Next.js frontend
├── docs/             Planning docs
└── hummingbot/       Reference implementation

Run make to see all available commands.