PipPaper is a comprehensive trade journaling and analysis platform designed to replicate the core functionality of premium tools like TradeZella, but open source and self-hosted. Built with Deno and Fresh, it provides advanced dashboards, trade logging, AI coaching, and more — all running locally so your data never leaves your machine.
Full overview with KPI cards (Total P&L, Win Rate, Profit Factor, etc.), equity curve, daily P&L chart, win ratio donut, performance calendar, and win/loss streaks.
All trades in a searchable, filterable table with summary cards. Filter by symbol, status (Win/Loss/Even), broker, setup, and date range. Paginated with 25/50/100 rows per page.
Modal form to manually add trades with symbol, side, entry/exit prices, quantity, P&L, commission, dates, stop loss, and profit target.
Full trade view with custom candlestick charts (powered by Yahoo Finance data), execution details, trade analysis, and rich text journal. Includes AI Trade Coach integration for instant feedback.
Performance breakdown by day, symbol, and hour of day. Includes day-by-day table showing trade count, P&L, and green/red day classification.
Define trading setups with descriptions, entry/exit rules, and color-coded tags. Track performance stats (win rate, net P&L) per setup automatically.
Daily trade plan editor and free-form journal with a rich text editor (bold, italic, lists, code blocks, links, images). Past entries displayed chronologically.
Upload Tradovate CSV exports with drag-and-drop. Supported brokers listed with roadmap for NinjaTrader, MetaTrader, and Interactive Brokers.
Create and manage custom tags by category (Mistake, Setup, General) with color coding. Tags are used for trade analysis and filtering.
Configure AI Model (dynamically discovered from Google Gemini API), manage data, and backup/restore your entire journal via zipped JSON export.
Full light/dark theme toggle via the sidebar. Preference is persisted in localStorage.
- Dashboard — Total P&L, Win Rate, Profit Factor, Expectancy, Equity Curve, Daily P&L chart, Win/Loss donut charts, Performance Calendar, Win/Loss streaks
- Trade Log — Full trade table with filtering (symbol, status, broker, setup, date range), pagination (25/50/100), click-through to trade detail
- Interactive Charts — Canvas-based candlestick charts with volume, entry/exit markers, and auto-fetched kline data (1m/5m/1d intervals) from Yahoo Finance. Data is cached locally.
- AI Trade Coach — Instant trade analysis using Google Gemini models (dynamically discovered). Provides feedback on execution, risk management, and psychology, plus a 1-5 star rating with reasoning.
- Trade Detail — Execution details, R-multiple calculation, entry/exit reason tracking, setup & mistake tagging, rich text trade journal
- Add Manual Trade — Full modal form for manual trade entry with auto-calculated P&L
- Daily Stats — Performance by day, symbol, and hour of day with day-by-day table
- Playbook — Define trading setups with rules, track per-setup performance automatically
- Notebook — Daily trade plan + free-form journal with rich text editor (Quill)
- Import — Tradovate CSV import with automatic trade parsing
- Backup & Restore — Full export/import of all data (trades, notes, settings) to zipped JSON
- Settings — Custom tag management (Mistake/Setup/General), AI Coach config, account settings
- Dark/Light Theme — Full theme toggle persisted in localStorage
- Mobile Responsive — Collapsible sidebar with hamburger menu
- Privacy First — All data stored locally via Deno KV, never leaves your machine
- Deno v1.40+
git clone https://github.com/DennisRutjes/PipPaper.git
cd PipPaper
chmod +x start.sh
./start.shgit clone https://github.com/DennisRutjes/PipPaper.git
cd PipPaper
start.batThe start scripts will:
- Check if Deno is installed (install it automatically if missing)
- Create a
.envfile from.env.exampleif one doesn't exist - Start the development server at http://localhost:8000
# Install dependencies and start dev server
deno task startOpen .env and add your API key:
LLM_PROVIDER=gemini
GEMINI_API_KEY=your_key_hereGo to Settings > General to select your preferred AI Model (e.g. Gemini 1.5 Pro, Gemini 1.5 Flash).
| Layer | Technology |
|---|---|
| Runtime | Deno |
| Framework | Fresh (Preact-based SSR) |
| Styling | Tailwind CSS via Twind |
| Database | Deno KV (local, zero-config) |
| Charts | Canvas API + Fresh Charts |
| Rich Editor | Quill |
| AI | Google Gemini (REST API) |
- Dashboard (P&L, Win Rate, Equity Curve, Calendar)
- Trade Log with filtering and pagination
- Trade Detail with Canvas Candlestick Chart
- Manual trade entry
- Tradovate CSV Import
- AI Coach Integration (Dynamic Gemini Models)
- Playbook (trading setups with performance tracking)
- Notebook (daily plan + journal)
- Settings (custom tags, general config, AI model selector)
- Backup & Restore (Export/Import)
- Dark/Light theme toggle
- Mobile responsive layout
- Symbol mapping configuration
- NinjaTrader / MetaTrader / IBKR import
- Multi-account support
MIT