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

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

Built distribution (wheel)

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

Total release size: 48.3 kB

Release files / fere_cli-0.5.0.dev53.tar.gz

Download URL	fere_cli-0.5.0.dev53.tar.gz
Size	24.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`37fa079c79e2b8d9eb2f75f5317644be85cea3be59d0070ab8a982cf366d264e`
BLAKE2b-256 checksum How to use checksums	`f48e641c71074593c8cabada8cee8888539bb965a7dc62714ca1e4518bfaa5ea`
Upload date	Oct 22, 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.dev53-py3-none-any.whl

Download URL	fere_cli-0.5.0.dev53-py3-none-any.whl
Size	24.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`85a7935aced26d0c3e093a6598f504629729a21c79f6b7e38d34089ef433d254`
BLAKE2b-256 checksum How to use checksums	`0a00c1ea09ddfeb660f824bdc298611bd75e2af210dad08e6cd9382de89a1aec`
Upload date	Oct 22, 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.dev53

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.