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.5.0

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.5.0
File	Size	Uploaded	Provenance
fere_cli-0.5.0.tar.gz	24.1 kB	Oct 23, 2026	Without provenance	Details

Built distribution (wheel)

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

Total release size: 48.3 kB

Release files / fere_cli-0.5.0.tar.gz

Download URL	fere_cli-0.5.0.tar.gz
Size	24.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`786b37c0030d0bfd30fbc98f948942967a0f22d9d5cb3f696005e52261686ecc`
BLAKE2b-256 checksum How to use checksums	`8025318954d228c29edb3d21a22bca405d1472bec91960c6b8c0e1280dbeba73`
Upload date	Oct 23, 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.5.0-py3-none-any.whl

Download URL	fere_cli-0.5.0-py3-none-any.whl
Size	24.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1dbcaa7ff527bd34ee2ce766a3887d3c3e45ec87da0922068106a030ecb7df41`
BLAKE2b-256 checksum How to use checksums	`50468c6ff216524b1dec4406dfc586964ec787f6c067c3767dee43a9bf1cf1ef`
Upload date	Oct 23, 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.5.0

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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.