FereAI CLI

Terminal-first interface for FereAI crypto trading and research. Wraps the FereAI Gateway API — same capabilities as the Python and TypeScript SDKs.

Install

Recommended (script installer, handles pipx/pip and PATH setup):

curl -fsSL https://api.fereai.xyz/install.sh | sh

Manual (advanced, for humans in controlled environments only):

pip install fere-cli

Quick Start

# Authenticate (first-run — creates agent, generates keys)
fere auth

# Chat with the AI agent
fere chat "what is the price of ETH?"

# Interactive chat REPL
fere chat

# Stream responses in real-time
fere chat --stream "top 5 memecoins on Base"

# Check your wallets and holdings
fere wallets
fere holdings

# Execute a swap
fere swap \
  --chain-in 8453 --chain-out 8453 \
  --token-in 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE \
  --token-out 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 \
  --amount 1000000000000000000

# Check credits
fere credits

# View supported chains
fere chains

JSON Output (for scripts & AI agents)

Every command supports --json for machine-readable output:

fere --json credits
# {"ok": true, "data": {"credits_available": 150.0}}

fere --json holdings
# {"ok": true, "data": {...}}

Streaming chat in JSON mode outputs NDJSON (one event per line):

fere --json chat --stream "price of SOL"

Commands

Command	Description
`fere auth`	Authenticate and register agent
`fere whoami`	Show agent identity and wallets
`fere credits`	Check credit balance
`fere chat [QUERY]`	Chat with AI (one-shot or REPL)
`fere threads`	List chat threads
`fere swap`	Execute token swap
`fere limit-order create`	Create limit order
`fere limit-order list`	List limit orders
`fere limit-order cancel ID`	Cancel limit order
`fere hooks set`	Set stop-loss / take-profit
`fere wallets`	Show wallet addresses
`fere holdings`	Show token holdings
`fere notifications`	Show notifications
`fere earn info`	Show APY and vault info
`fere earn deposit`	Deposit USDC
`fere earn withdraw`	Withdraw USDC
`fere earn positions`	Show yield positions
`fere chains`	List supported chains
`fere status`	Check API connectivity
`fere config`	Show/edit CLI config

Global Flags

Flag	Env Var	Description
`--json`	—	Machine-readable JSON output
`--quiet`	—	Minimal output
`--agent NAME`	`FERE_AGENT_NAME`	Agent name override
`--base-url URL`	`FERE_BASE_URL`	API URL override

Configuration

Config is stored at ~/.fere/config.json. Keys are stored at ~/.fere/keys.json (managed by the SDK).

fere config                          # Show current config
fere config set agent_name my-bot    # Change agent name
fere config set base_url http://localhost:8003  # Point to local gateway

Agent-Friendly

Exit codes: 0 success, 1 error
Non-interactive when stdin is not a TTY (all prompts skipped)
--json output: {"ok": true, "data": {...}} or {"ok": false, "error": "..."}
Streaming JSON: NDJSON format
No ANSI colors when piped

Download files

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

Source Distribution

fere_cli-0.4.0.dev49.tar.gz (23.8 kB view details)

Uploaded Sep 5, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fere_cli-0.4.0.dev49-py3-none-any.whl (24.0 kB view details)

Uploaded Sep 5, 2026 Python 3

File details

Details for the file fere_cli-0.4.0.dev49.tar.gz.

File metadata

Download URL: fere_cli-0.4.0.dev49.tar.gz
Upload date: Sep 5, 2026
Size: 23.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.15

File hashes

Hashes for fere_cli-0.4.0.dev49.tar.gz
Algorithm	Hash digest
SHA256	`58964c90e97d5c7186b62a26e0d88b67b87aac0be9f7e8da468657a183e51f60`
MD5	`15f100bc1697259384c3790331c28795`
BLAKE2b-256	`13d59739db764563128879df5718c8f02561938c951744d51755e8a555ab09f9`

See more details on using hashes here.

File details

Details for the file fere_cli-0.4.0.dev49-py3-none-any.whl.

File metadata

Download URL: fere_cli-0.4.0.dev49-py3-none-any.whl
Upload date: Sep 5, 2026
Size: 24.0 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.15

File hashes

Hashes for fere_cli-0.4.0.dev49-py3-none-any.whl
Algorithm	Hash digest
SHA256	`fc8fc6a4735f9fa487dac29db2ceffd08febcbccf53451cad8438ceb6abeb6ed`
MD5	`5fe16166648e2d06660c73d479c95c21`
BLAKE2b-256	`1fa1ae554dbf4381daefcf1c2964d77456537674ba5ab39407d1bbd956b91491`