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

Metadata

Release files for fere-cli 0.4.0.dev51

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fere-cli 0.4.0.dev51
File	Size	Uploaded	Provenance
fere_cli-0.4.0.dev51.tar.gz	23.9 kB	Oct 13, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for fere-cli 0.4.0.dev51
File	Interpreter	ABI	Platform	Reset
fere_cli-0.4.0.dev51-py3-none-any.whl 24.0 kB Oct 13, 2026 Without provenance	Python 3	none	any	Details

Total release size: 48.0 kB

Release files / fere_cli-0.4.0.dev51.tar.gz

Download URL	fere_cli-0.4.0.dev51.tar.gz
Size	23.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`524fe84effa1c4b6e3325969ac2e6779e778068e3fe627e2a3204b07ca9aab06`
BLAKE2b-256 checksum How to use checksums	`f7cc2ace26b2cfb9bae170f4a1dc7726bd40e29182f94af87519bae78055348c`
Upload date	Oct 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Release files / fere_cli-0.4.0.dev51-py3-none-any.whl

Download URL	fere_cli-0.4.0.dev51-py3-none-any.whl
Size	24.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0dd0277eda9f417395b85b5aff28a2d680d773cb76e2794983bcca04ee4c552c`
BLAKE2b-256 checksum How to use checksums	`4f74a0ae6277629942a62fa475fd77ee71a4f6884b1329a9d4abf72def60f7eb`
Upload date	Oct 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Security for fere-cli 0.4.0.dev51

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.