PacificaPilot is a Python package. Requires Python 3.11+.

# Recommended — isolated with pipx
pipx install pacificapilot

# Or plain pip
pip install pacificapilot

# For development
git clone https://github.com/pacificapilot/pacificapilot
cd pacificapilot
pip install -e ".[dev,telegram,memory]"

Run the setup wizard once, then launch the TUI.

# First-run wizard
pacifica init
#  → Pacifica keys (public + private Solana keypair)
#  → AI provider (OpenRouter recommended for free tier)
#  → Trading config (symbols, position size, confidence)
#  → Supermemory (local, cloud, or skip)

# Launch the TUI
pacifica start

Inside the REPL you can type natural language or slash commands.

Config lives at ~/.pacificapilot/config.toml. Secrets live at ~/.pacificapilot/secrets.env with chmod 600. Edit directly or use the CLI.

pacifica config set pacifica.api_key <key>
pacifica config set pacifica.api_secret <secret>
pacifica config set risk.max_position_usd 500
pacifica config set trading.symbols "BTC,ETH,SOL"
pacifica config set trading.dry_run true

Configure at least one provider. Swap at runtime with /apikey or /model.

pacifica config set anthropic.api_key sk-ant-...
pacifica config set openai.api_key sk-...
pacifica config set google.api_key ...
pacifica config set openrouter.api_key ...

Use Claude for reasoning, GPT for speed, Gemini for the free tier — no lock-in.

Memory is powered by Supermemory. Two deployment modes with the same SDK:

# Cloud mode — get a key from app.supermemory.ai
pacifica config set supermemory.api_key sm_...
pacifica config set supermemory.mode cloud

# Local mode — zero data leaves your machine
npm i -g supermemory
npx supermemory local            # runs on localhost:6767
pacifica config set supermemory.mode local

Five container tags: decisions, patterns, preferences, performance, errors. Three operations: memory.add(), memory.recall(), memory.context().

Chat Agent

Claude Code-style multi-turn tool loop. Runs up to 8 iterations per turn (configurable) before returning a final response.

Loop Agent

Autonomous 24/7 monitoring on a configurable timer. Fetches live data, makes AI-driven trading decisions, and writes every decision + pattern to Supermemory automatically.

/start      # boot the autonomous Loop Agent
/pause      # soft-pause
/resume     # resume
/stop       # stop entirely

Pair your Telegram chat once, then monitor positions and trade in natural language from your phone. Only paired chat IDs are allowed.

# In the TUI — enables remote mode and shows a one-time code
/remote

# In Telegram — open your bot and bind the chat
/pair <code>

# After pairing: all /commands work, plus plain-English chat

You can also enable Telegram during the pacifica init setup wizard. Pairing codes expire — run /remote again for a fresh one.

Non-custodial, BYOK, human-in-the-loop. Dry-run and testnet by default.

[risk]
max_position_usd = 500
max_leverage = 3
daily_loss_limit_usd = 100
require_confirmation = true

[trading]
dry_run = true
network = "testnet"

• Keys on your machine, nowhere else.
• Every trade action requires explicit yes/no.
• Dry-run mode simulates all trades.
• Testnet-first onboarding — no real money at risk.
• Secrets file at ~/.pacificapilot/secrets.env with chmod 600.

Built with Textual. Fixed 3-panel layout:

• Header — mode (testnet/mainnet), dry-run status, provider, live BTC/ETH prices.
• Chat Panel — conversation with the AI agent and command output.
• Sidebar — live status: agent state, positions, account, decisions, memory.
• Input Bar — natural language or /commands with fuzzy autocomplete.

Keyboard: Ctrl+P palette, Ctrl+M provider switch.