Quick Start

This guide will get you trading with mucch in minutes. We'll walk through launching the bot, understanding the dashboard, and making your first AI-assisted trade.

Starting mucch

Once you've completed the installation and configuration, start mucch with:

$ mucch

Or if you installed locally:

$ npx mucch

Understanding the Dashboard

When mucch starts, you'll see a terminal dashboard with four main sections:

Live Price Charts

Real-time line charts showing BTC and ETH prices with color-coded lines:

Yellow line: BTC/USD price
Cyan line: ETH/USD price
Updates every 5 seconds with live market data

Account Information

Your account summary including:

Account Value: Total portfolio value in USD
Total PNL: Overall profit/loss across all positions
Unrealized PNL: P&L from open positions
Realized PNL: P&L from closed positions

AI Trading Signals

Real-time AI analysis for BTC and ETH showing:

BUY: AI recommends entering a long position
SELL: AI recommends entering a short position or closing longs
HOLD: AI recommends waiting for better conditions
Confidence: AI's confidence level (0-100%)
Reasoning: Detailed explanation of the signal

Open Positions

Table showing all active positions with:

Asset: Trading pair (e.g., BTC, ETH)
Side: Long or Short
Size: Position size in base currency
Entry Price: Average entry price
PNL: Current profit/loss for this position

Making Your First Trade

mucch provides AI signals in real-time. Here's how to interpret and act on them:

Step 1: Wait for a High-Confidence Signal

The AI will continuously analyze BTC and ETH. Look for signals with:

✓

Confidence score above 70%

✓

Clear BUY or SELL action

✓

Detailed reasoning that makes sense

Step 2: Review the AI's Reasoning

Example AI signal:

┌─ AI Signals ────────────────────────────────────┐
│                                                  │
│ BTC: BUY (85% confidence)                       │
│ Strong bullish momentum with volume             │
│ confirmation. RSI oversold, MACD crossover.      │
│                                                  │
│ Entry: $42,150                                   │
│ Stop Loss: $41,500                               │
│ Take Profit: $43,800                             │
│ Position Size: $250                              │
│                                                  │
└──────────────────────────────────────────────────┘

Step 3: Execute the Trade (Manual)

Currently, mucch operates in signal-only mode. The AI provides recommendations, but you must manually execute trades. This ensures you maintain full control.

Important: Always verify AI signals before trading. The AI provides suggestions based on technical analysis, but markets are unpredictable. Use your own judgment.

Keyboard Controls

Key	Action
q	Quit mucch
ESC	Quit mucch
Ctrl+C	Force quit

Running 24/7

To keep mucch running continuously, use a process manager like PM2:

Install PM2

$ npm install -g pm2

Start mucch with PM2

$ pm2 start "npx mucch" --name mucch[PM2] Starting mucch in fork mode[PM2] Done.

Useful PM2 Commands

$ pm2 logs mucch      # View live logs$ pm2 status          # Check status$ pm2 stop mucch      # Stop the bot$ pm2 restart mucch   # Restart after config changes$ pm2 delete mucch    # Remove from PM2

Reading AI Signals

The AI analyzes markets using multiple technical indicators. Here's what each signal component means:

Action

BUY: AI suggests entering a long position (betting price will go up)

SELL: AI suggests entering a short position (betting price will go down)

HOLD: AI suggests waiting, market conditions unclear

Confidence Score

The AI's confidence in its recommendation, expressed as a percentage:

85-100%: Very high confidence, strong signal

70-84%: High confidence, good signal

50-69%: Moderate confidence, proceed with caution

<50%: Low confidence, typically results in HOLD

Entry/Exit Levels

The AI suggests optimal price levels for:

Entry Price: Suggested price to enter the position
Stop Loss: Price level to exit if trade goes against you
Take Profit: Price target to secure profits

Position Size

Suggested position size in USD based on your configured risk percentage and account value. The AI calculates this to keep your risk within acceptable limits.

Best Practices

Monitor multiple timeframes: Check higher timeframes on TradingView for confluence with AI signals

Start conservative: Begin with low risk (0.5-1%) and small position sizes

Keep a trading journal: Record which AI signals you act on and track results

Use stop losses: Always set stop losses to limit downside risk

Be patient: Wait for high-confidence signals. Quality over quantity

When to Stop Trading

Know when to step away:

Hit daily loss limit: If you lose more than 2-3% in a day, stop and review

Emotional trading: If you find yourself ignoring signals or overtrading, take a break

Market uncertainty: During major news events or high volatility, consider stepping aside

Next Steps

Now that you understand the basics, dive deeper into:

AI Strategy Deep Dive

Learn how the AI makes trading decisions

Dashboard Guide

Master the terminal interface

Configuration AI Strategy