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.
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
/helpfor commands, or just chat naturally /startboots the Loop Agent,/stopstops it/configto 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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c16d8fd7254a652c3a32203253a771b6ca73b52a2e50ae705a1727609dc8d84f
|
|
| MD5 |
f5b15301173345d7e44a7c2062b9f229
|
|
| BLAKE2b-256 |
c8a452d5ebf4c7cd7c6c2016ed51bceb5232f2550d16f78fe4e315f06f851656
|
Provenance
The following attestation bundles were made for pacificapilot-0.1.0.tar.gz:
Publisher:
publish.yml on MayurK-cmd/Pacifica-Pilot
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pacificapilot-0.1.0.tar.gz -
Subject digest:
c16d8fd7254a652c3a32203253a771b6ca73b52a2e50ae705a1727609dc8d84f - Sigstore transparency entry: 2148091062
- Sigstore integration time:
-
Permalink:
MayurK-cmd/Pacifica-Pilot@3afbd419573c03e0dff9fd3ac9bcafef36585aa2 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/MayurK-cmd
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@3afbd419573c03e0dff9fd3ac9bcafef36585aa2 -
Trigger Event:
push
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8f988379919777feee1cb92eeefae71fe808a0c36aa8de22108c35fb795c3059
|
|
| MD5 |
9bcb6bfa0596cd2790e51925494d1072
|
|
| BLAKE2b-256 |
7dc1f24f011a87a3c2fb7cf3461c6fcde154a5447f27a3955e2000f6296c2c90
|
Provenance
The following attestation bundles were made for pacificapilot-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on MayurK-cmd/Pacifica-Pilot
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pacificapilot-0.1.0-py3-none-any.whl -
Subject digest:
8f988379919777feee1cb92eeefae71fe808a0c36aa8de22108c35fb795c3059 - Sigstore transparency entry: 2148091064
- Sigstore integration time:
-
Permalink:
MayurK-cmd/Pacifica-Pilot@3afbd419573c03e0dff9fd3ac9bcafef36585aa2 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/MayurK-cmd
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@3afbd419573c03e0dff9fd3ac9bcafef36585aa2 -
Trigger Event:
push
-
Statement type: