Skip to main content

Terminal-native, non-custodial AI trading agent for Pacifica Perpetual Futures

Project description

PacificaPilot 🤖⚡

AI trading agent for Pacifica Perpetual Futures — with persistent memory, multi-provider AI, and natural language trading.

License Python Status

pip install pacificapilot
pacifica init
pacifica start

Features

  • Persistent memory — Every trade, pattern, and preference stored in Supermemory across sessions
  • Agentic chat — Multi-turn tool loop: gathers data, reasons, then responds
  • Autonomous loop agent — 24/7 AI-driven market monitoring
  • 9 trading tools — place/close orders, market analysis, performance metrics, regime detection
  • Live technical analysis — RSI, MACD, Bollinger Bands, funding, volume, market regime
  • Multi-provider AI — Anthropic, OpenAI, Google Gemini, OpenRouter (BYOK)
  • Textual TUI — 3-panel layout with slash autocomplete, live sidebar, keyboard shortcuts
  • Non-custodial — Your keys, your machine. Nothing leaves.
  • Dual-mode memory — Local (localhost:6767) or cloud (Supermemory API)

Quick Start

# Install
pip install pacificapilot

# Setup wizard
pacifica init
# → Pacifica keys → AI provider → Trading config → Supermemory → Telegram

# Launch TUI
pacifica start

Inside the TUI:

  • Type /help for commands, or just chat naturally
  • /start boots the Loop Agent, /stop stops it
  • /config to view/edit settings
  • /apikey supermemory <key> [local|cloud]

Keyboard shortcuts

Ctrl+P — Command palette    Ctrl+M — Switch AI provider
Ctrl+S — Settings toggles   Ctrl+L — Clear chat
Ctrl+R — Refresh sidebar     Ctrl+D — Toggle dry run
Ctrl+K — API key management  Ctrl+T — Mode switch
Ctrl+Q — Quit

Example

You:  how are BTC markets right now?
Agent: BTC — $63,996
  Regime: Weak uptrend (MACD bullish)
  RSI 5m: 35 (leaning oversold) | RSI 1h: 51 (neutral)
  Bollinger: Upper half, bandwidth 4.2%
  → NEUTRAL with slight bullish bias. No clear entry.

Architecture

Chat Agent (tool loop) ←→ Trading Core ←→ Pacifica API
     ↕                       ↕
Loop Agent (autonomous)   Supermemory
     ↕
Textual TUI (3-panel)

Tools

place_order · close_position · close_all_positions · get_positions · get_account_balance · get_market_price (enriched) · get_trade_history · get_performance_metrics · get_market_regime

Supermemory

Every AI decision, market pattern, user preference, and daily summary is stored in Supermemory — a persistent, searchable memory layer that survives restarts.

decisions    → "LONG BTC, confidence 75%, RSI 35"
patterns     → "Funding spike on ETH: 0.003"
preferences  → "Never trade BONK" — said once, remembered forever
performance  → "Daily: 3 trades, +$12.50, 67% win rate"

Two modes:

  • Cloud: https://app.supermemory.ai (default)
  • Local: npx supermemory local (offline, zero data leaves your machine)

Security

  • Non-custodial — Keys stored in ~/.pacificapilot/secrets.env (chmod 600)
  • BYOK — Your AI keys go directly to your provider
  • Confirmation prompts — Every trade requires explicit yes/no
  • Testnet first — Dry run by default, mainnet with confirmation

Links

Disclaimer: PacificaPilot is experimental software for educational purposes. Trading perpetual futures carries significant risk. AI decisions are not financial advice. Start with testnet.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pacificapilot-0.1.0.tar.gz (107.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pacificapilot-0.1.0-py3-none-any.whl (126.2 kB view details)

Uploaded Python 3

File details

Details for the file pacificapilot-0.1.0.tar.gz.

File metadata

  • Download URL: pacificapilot-0.1.0.tar.gz
  • Upload date:
  • Size: 107.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pacificapilot-0.1.0.tar.gz
Algorithm Hash digest
SHA256 c16d8fd7254a652c3a32203253a771b6ca73b52a2e50ae705a1727609dc8d84f
MD5 f5b15301173345d7e44a7c2062b9f229
BLAKE2b-256 c8a452d5ebf4c7cd7c6c2016ed51bceb5232f2550d16f78fe4e315f06f851656

See more details on using hashes here.

Provenance

The following attestation bundles were made for pacificapilot-0.1.0.tar.gz:

Publisher: publish.yml on MayurK-cmd/Pacifica-Pilot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pacificapilot-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: pacificapilot-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 126.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pacificapilot-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8f988379919777feee1cb92eeefae71fe808a0c36aa8de22108c35fb795c3059
MD5 9bcb6bfa0596cd2790e51925494d1072
BLAKE2b-256 7dc1f24f011a87a3c2fb7cf3461c6fcde154a5447f27a3955e2000f6296c2c90

See more details on using hashes here.

Provenance

The following attestation bundles were made for pacificapilot-0.1.0-py3-none-any.whl:

Publisher: publish.yml on MayurK-cmd/Pacifica-Pilot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page