Setup Guide

From install to your first AI inference — everything you need.

In this guide

1. Install Pistachio 2. Set Up Your Wallet 3. Get MOR Tokens 4. Get ETH on Base 5. Claim Your Free Pass 6. Start Pistachio 7. Your First Inference CLI Reference Troubleshooting

Install Pistachio

macOS (recommended)

Desktop app + CLI

brew tap drm3labs/drm3 && brew install --cask pistachio

CLI only

brew tap drm3labs/drm3 && brew install pistachio

Linux

curl -fsSL https://raw.githubusercontent.com/drm3labs/drm3-releases/main/products/pistachio/install.sh | sh

Works on x86_64 and ARM64 (auto-detected). Re-run to update.

Windows (via WSL2)

PowerShell as admin (one time)

wsl --install

Restart your computer, open Ubuntu from the Start menu, then run the Linux command above. WSL2 forwards ports automatically — open http://localhost:19377 in your Windows browser.

Chromebook

Enable Linux (Settings → Advanced → Developers → Linux), open Terminal, then run the Linux command above.

Verify

pistachio --version

Update to latest version

Homebrew (macOS)

brew upgrade drm3labs/drm3/pistachio

Homebrew desktop app

brew upgrade --cask drm3labs/drm3/pistachio

Linux / WSL2 (re-run install script)

curl -fsSL https://raw.githubusercontent.com/drm3labs/drm3-releases/main/products/pistachio/install.sh | sh

Reinstall same version

brew reinstall drm3labs/drm3/pistachio

Uninstall

Homebrew

brew uninstall pistachio

Linux (manual install)

sudo rm /usr/local/bin/pistachio

Your wallet config at ~/.mor/config.toml is not removed by uninstall.

macOS Gatekeeper: If you downloaded the binary directly (not via Homebrew), run: xattr -d com.apple.quarantine /usr/local/bin/pistachio

Set Up Your Wallet

Pistachio uses your Ethereum wallet as your identity. Your private key never leaves your machine — it's stored locally with restricted file permissions.

If you already have a wallet

pistachio config set private-key

Paste your private key when prompted (hex string starting with 0x, 66 characters).

Or set it as an environment variable:

export PISTACHIO_PRIVATE_KEY=0x...

If you need a wallet

The easiest way is MetaMask:

Install the MetaMask browser extension
Create a new wallet — save your seed phrase somewhere safe
Export your private key: Settings → Security → Export Private Key
Run pistachio config set private-key and paste it

Important: This wallet controls your MOR stake and your identity on the network. Back up your seed phrase. If you lose access, you lose any staked MOR. The private key can only be set from the command line — this is intentional for security.

Get MOR Tokens

MOR is the native token of the Morpheus network. You stake MOR to access AI models.

MOR must be on the Base network — not Ethereum mainnet, not Arbitrum.

Buy MOR on Uniswap

Go to Uniswap
Connect your wallet and switch to Base network
Swap ETH (or USDC) for MOR

MOR contract on Base: 0x7431aDa8a591C955a994a21710752EF9b882b8e3

Also available via MetaMask Swaps or Coinbase DEX (both on Base).

How much? Start with 10–20 MOR. With the free Starter pass you can stake up to 20 MOR — enough for roughly 20–30 minutes of inference on most models.

Get ETH on Base

You need a small amount of ETH on Base for transaction fees. $5–10 is more than enough — gas on Base costs fractions of a cent.

Coinbase: Buy ETH and withdraw directly to Base (cheapest)
Bridge: Use the Base Bridge from Ethereum mainnet
Exchange: Most exchanges support Base network withdrawals

Claim Your Free Pass

DRM3Pass is a free NFT that gives you 20 MOR of staking capacity. You need it before you can open inference sessions.

Claim via web

Go to drm3.network/claim
Connect the same wallet you configured in Pistachio
Claim your free Starter pass (costs ~$0.01 in gas)

Claim via CLI

pistachio claim-pass

Want more capacity? NFT passes are additive. Bronze (+200 MOR, 5 MOR), Silver (+1,000 MOR, 20 MOR), Gold (+5,000 MOR, 80 MOR), Diamond (+20,000 MOR, 250 MOR). Bigger stake = longer sessions = less gas over time. Get a pass →

Start Pistachio

pistachio serve

Dashboard opens at http://localhost:19377. You'll see your wallet balance, available models, and active sessions.

Your First Inference

From the CLI

pistachio chat "Explain how proof of stake works" --model llama-3.3-70b

Pistachio automatically stakes MOR and opens a session if needed.

From the dashboard

Open localhost:19377 and use the chat interface.

Via API (OpenAI-compatible)

curl http://localhost:19377/inference/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"llama-3.3-70b","messages":[{"role":"user","content":"Hello"}]}'

No API key required — your wallet is your identity.

With Claude Code

ANTHROPIC_BASE_URL=http://localhost:19377/inference claude

CLI Reference

Configuration

pistachio config show
pistachio config set private-key
pistachio config set port 8080
pistachio config path
pistachio config reset

Wallet

pistachio wallet balance
pistachio wallet approve

Sessions

pistachio session list
pistachio session open llama-3.3-70b --stake 5
pistachio session close --session 0x...
pistachio session renew-all

Models

pistachio catalog list
pistachio catalog refresh
pistachio catalog probe
pistachio catalog filter --healthy --capacity

Other

pistachio info
pistachio lanes
pistachio chat "prompt" --stream
pistachio claim-pass
pistachio uninstall

Run any command with --help for full details.

Troubleshooting

"No private key configured"

If you installed the desktop app, paste your key directly in the app when prompted. From the CLI:

pistachio config set private-key

This prompts securely — the key is never shown in terminal history.

Change your wallet / wrong wallet

If you're connected to the wrong wallet, update it:

pistachio config set private-key

Then restart Pistachio. Your config is at ~/.pistachio/config.toml.

Check which wallet is active

pistachio config show

"No DRM3Pass found" / "Consumer pass required"

Your wallet needs a DRM3Pass NFT. Claim one for free:

Web: nft.drm3.xyz
CLI: pistachio claim-pass

Make sure you claim with the same wallet that Pistachio is configured with.

Stale binary after upgrade

If you see an old version after upgrading, you may have a stale binary from a previous install method:

which pistachio

Should show /opt/homebrew/bin/pistachio (Homebrew). If it shows /usr/local/bin/pistachio, remove the old one:

sudo rm /usr/local/bin/pistachio

"Insufficient MOR balance"

You need MOR on the Base network. MOR on Ethereum mainnet or Arbitrum won't work — you need to bridge or swap on Base.

"Insufficient ETH for gas"

You need a small amount of ETH on Base for transaction fees. $5 is plenty.

Port already in use

pistachio config set port 8080

Sessions expiring quickly

Session length depends on your stake amount. Stake more MOR for longer sessions, or upgrade your pass for higher capacity.

pistachio session renew-all

Models not loading

pistachio catalog refresh
pistachio catalog probe

Full diagnostic

pistachio info
pistachio config show
pistachio wallet balance
pistachio session list
pistachio --version

Check status.drm3.network to see if the network is healthy.

Useful Links

Download Pistachio → Claim Your Free Pass → NFT Marketplace → Network Status → Block Explorer → Pistachio Overview →

Terms · Privacy