fere-cli 0.1.0__tar.gz

fere_cli-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+*.log
+*.pyc
+__pycache__
+
+# Devcontainer local env (contains secrets)
+.devcontainer/.env.local
+.devcontainer/.env.gitpod
+
+# Git worktrees
+.worktrees/
+
+# tmp/ — keep .gitkeep, ignore all else
+tmp/*
+!tmp/.gitkeep
+coverage.xml
+
+# Eval output
+compare_results.json

fere_cli-0.1.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: fere-cli
+Version: 0.1.0
+Summary: Terminal CLI for FereAI crypto trading and research
+Author-email: Fere AI <info@fere.ai>
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1
+Requires-Dist: fere-sdk>=0.1.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# FereAI CLI
+
+Terminal-first interface for FereAI crypto trading and research. Wraps the [FereAI Gateway API](https://api.fereai.xyz) — same capabilities as the Python and TypeScript SDKs.
+
+## Install
+
+```bash
+curl -fsSL https://api.fereai.xyz/install.sh | sh
+```
+
+Or with pip:
+
+```bash
+pip install fere-cli
+```
+
+## Quick Start
+
+```bash
+# 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:
+
+```bash
+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):
+
+```bash
+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).
+
+```bash
+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

fere_cli-0.1.0/README.md

@@ -0,0 +1,118 @@
+# FereAI CLI
+
+Terminal-first interface for FereAI crypto trading and research. Wraps the [FereAI Gateway API](https://api.fereai.xyz) — same capabilities as the Python and TypeScript SDKs.
+
+## Install
+
+```bash
+curl -fsSL https://api.fereai.xyz/install.sh | sh
+```
+
+Or with pip:
+
+```bash
+pip install fere-cli
+```
+
+## Quick Start
+
+```bash
+# 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:
+
+```bash
+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):
+
+```bash
+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).
+
+```bash
+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

fere_cli-0.1.0/install.sh

@@ -0,0 +1,114 @@
+#!/bin/sh
+# FereAI CLI Installer
+# Usage: curl -fsSL https://api.fereai.xyz/install.sh | sh
+#
+# Installs the `fere` CLI tool via pipx (recommended) or pip.
+# Supports macOS and Linux.
+
+set -e
+
+VERSION="0.1.0"
+PACKAGE="fere-cli"
+
+# Colors (disabled if not a TTY)
+if [ -t 1 ]; then
+    RED='\033[0;31m'
+    GREEN='\033[0;32m'
+    YELLOW='\033[0;33m'
+    DIM='\033[2m'
+    RESET='\033[0m'
+else
+    RED=''
+    GREEN=''
+    YELLOW=''
+    DIM=''
+    RESET=''
+fi
+
+info() { printf "${DIM}%s${RESET}\n" "$1"; }
+success() { printf "${GREEN}%s${RESET}\n" "$1"; }
+warn() { printf "${YELLOW}%s${RESET}\n" "$1"; }
+error() { printf "${RED}Error: %s${RESET}\n" "$1" >&2; exit 1; }
+
+# Detect OS
+OS="$(uname -s)"
+case "$OS" in
+    Darwin) OS_NAME="macOS" ;;
+    Linux)  OS_NAME="Linux" ;;
+    *)      error "Unsupported OS: $OS. Use pip install $PACKAGE instead." ;;
+esac
+
+info "Installing FereAI CLI v${VERSION} on ${OS_NAME}..."
+
+# Check Python 3.10+
+check_python() {
+    for cmd in python3 python; do
+        if command -v "$cmd" >/dev/null 2>&1; then
+            ver=$("$cmd" -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")' 2>/dev/null)
+            major=$(echo "$ver" | cut -d. -f1)
+            minor=$(echo "$ver" | cut -d. -f2)
+            if [ "$major" -ge 3 ] && [ "$minor" -ge 10 ]; then
+                echo "$cmd"
+                return 0
+            fi
+        fi
+    done
+    return 1
+}
+
+PYTHON=$(check_python) || error "Python 3.10+ is required. Install it from https://python.org"
+info "Found Python: $($PYTHON --version)"
+
+# Prefer pipx for isolated installs
+install_with_pipx() {
+    if command -v pipx >/dev/null 2>&1; then
+        info "Installing with pipx..."
+        pipx install "$PACKAGE" || pipx upgrade "$PACKAGE"
+        return 0
+    fi
+    return 1
+}
+
+install_pipx() {
+    info "Installing pipx..."
+    if command -v brew >/dev/null 2>&1; then
+        brew install pipx
+    elif [ "$OS" = "Linux" ]; then
+        $PYTHON -m pip install --user pipx 2>/dev/null || \
+            $PYTHON -m ensurepip --default-pip 2>/dev/null && \
+            $PYTHON -m pip install --user pipx
+    else
+        $PYTHON -m pip install --user pipx
+    fi
+    pipx ensurepath 2>/dev/null || true
+}
+
+install_with_pip() {
+    info "Installing with pip..."
+    $PYTHON -m pip install --user "$PACKAGE"
+}
+
+# Try pipx first, then install pipx, then fall back to pip
+if install_with_pipx; then
+    : # success
+elif install_pipx && install_with_pipx; then
+    : # success
+else
+    warn "pipx not available, falling back to pip..."
+    install_with_pip
+fi
+
+# Verify installation
+if command -v fere >/dev/null 2>&1; then
+    success "FereAI CLI installed successfully!"
+    echo ""
+    info "Get started:"
+    echo "  fere auth          # Set up your agent"
+    echo "  fere chat \"hello\"  # Chat with the AI"
+    echo "  fere --help        # See all commands"
+else
+    warn "Installation complete, but 'fere' is not in PATH."
+    warn "You may need to restart your shell or add ~/.local/bin to PATH:"
+    echo ""
+    echo "  export PATH=\"\$HOME/.local/bin:\$PATH\""
+fi

fere_cli-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "fere-cli"
+version = "0.1.0"
+description = "Terminal CLI for FereAI crypto trading and research"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "Fere AI", email = "info@fere.ai" }]
+dependencies = [
+    "fere-sdk>=0.1.0",
+    "click>=8.1",
+    "rich>=13.0",
+]
+
+[project.scripts]
+fere = "fere_cli.main:cli"
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pytest-asyncio>=0.24"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/fere_cli"]

fere_cli-0.1.0/src/fere_cli/__init__.py

@@ -0,0 +1,3 @@
+"""FereAI CLI — terminal interface for crypto trading and research."""
+
+__version__ = "0.1.0"

fere_cli-0.1.0/src/fere_cli/async_util.py

@@ -0,0 +1,63 @@
+"""Async bridge utilities for the CLI.
+
+Click commands are synchronous; the SDK is async. This module
+bridges the two with a thin ``run_async`` wrapper and a
+``get_client`` factory.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import sys
+from functools import wraps
+from typing import Any, Callable
+
+import click
+from fere_sdk import FereClient
+
+from .config import load_config
+
+
+def run_async(coro):
+    """Run an async coroutine from synchronous context."""
+    return asyncio.run(coro)
+
+
+def async_command(f: Callable) -> Callable:
+    """Decorator: wraps an async function for use as a Click command."""
+
+    @wraps(f)
+    def wrapper(*args, **kwargs):
+        return run_async(f(*args, **kwargs))
+
+    return wrapper
+
+
+async def get_client(ctx: click.Context) -> FereClient:
+    """Create an authenticated FereClient from config + CLI overrides.
+
+    Raises click.ClickException if no agent name is configured.
+    """
+    cfg = load_config()
+
+    # CLI flag overrides
+    agent_name = ctx.obj.get("agent_override") or cfg.get("agent_name")
+    base_url = ctx.obj.get("base_url_override") or cfg.get("base_url")
+    key_path = cfg.get("key_path")
+
+    if not agent_name:
+        raise click.ClickException(
+            "No agent configured. Run 'fere auth' first "
+            "or pass --agent NAME."
+        )
+
+    return await FereClient.create(
+        agent_name=agent_name,
+        base_url=base_url,
+        key_path=key_path,
+    )
+
+
+def is_tty() -> bool:
+    """Check if stdin is a TTY (interactive terminal)."""
+    return sys.stdin.isatty()

fere_cli-0.1.0/src/fere_cli/banner.py

@@ -0,0 +1,23 @@
+"""ASCII art banner for the Fere CLI."""
+
+from . import __version__
+
+# Simplified spiral motif + stylized "FERE AI" text
+# The spiral evokes the Fere AI logo's concentric swirl pattern
+# Kept under 70 chars wide for comfortable 80-col terminal display
+LOGO = r"""
+     . · .
+   ·       ·      _____ _____ ____  _____      _    ___
+  ·  . · .  ·    |  ___|  ___|  _ \| ____|    / \  |_ _|
+ ·  ·     ·  ·   | |_  | |_  | |_) |  _|     / _ \  | |
+ ·  ·  .  ·  ·   |  _| |  _| |  _ <| |___   / ___ \ | |
+ ·  ·     ·  ·   |_|   |___|_|_| \_\_____|  /_/   \_\___|
+  ·  · . ·  ·
+   ·       ·
+     · . ·
+"""
+
+
+def get_banner() -> str:
+    """Return the full banner string with version."""
+    return f"{LOGO}\n  v{__version__} — crypto trading & research from your terminal\n"

fere_cli-0.1.0/src/fere_cli/commands/auth.py

@@ -0,0 +1,108 @@
+"""Auth commands: fere auth, fere whoami, fere credits."""
+
+from __future__ import annotations
+
+import click
+from fere_sdk import FereClient
+from rich.console import Console
+
+from ..async_util import async_command, get_client, is_tty, run_async
+from ..config import load_config, save_config
+from ..output import print_error, print_success
+
+console = Console()
+
+
+@click.command()
+@click.option("--name", prompt=False, default=None, help="Agent name.")
+@click.pass_context
+@async_command
+async def auth(ctx, name: str | None):
+    """Authenticate and register a new agent (first-run setup)."""
+    cfg = load_config()
+
+    agent_name = (
+        ctx.obj.get("agent_override")
+        or name
+        or cfg.get("agent_name")
+    )
+    if not agent_name:
+        if is_tty():
+            agent_name = click.prompt("Agent name")
+        else:
+            raise click.ClickException(
+                "Agent name required. Pass --name or --agent."
+            )
+
+    base_url = ctx.obj.get("base_url_override") or cfg.get("base_url")
+    key_path = cfg.get("key_path")
+
+    try:
+        client = await FereClient.create(
+            agent_name=agent_name,
+            base_url=base_url,
+            key_path=key_path,
+        )
+
+        # Persist agent name to config
+        cfg["agent_name"] = agent_name
+        save_config(cfg)
+
+        user = await client.get_user()
+        await client.close()
+
+        print_success(
+            {
+                "status": "authenticated",
+                "agent_name": agent_name,
+                "user": user,
+            },
+            quiet_value=agent_name,
+        )
+    except Exception as e:
+        print_error(f"Authentication failed: {e}")
+        raise SystemExit(1)
+
+
+@click.command()
+@click.pass_context
+@async_command
+async def whoami(ctx):
+    """Show current agent identity and wallet addresses."""
+    try:
+        client = await get_client(ctx)
+        user = await client.get_user()
+        wallets_data = await client.get_wallets()
+        await client.close()
+
+        result = {**user}
+        if wallets_data:
+            result["wallets"] = wallets_data
+
+        print_success(result)
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)
+
+
+@click.command()
+@click.pass_context
+@async_command
+async def credits(ctx):
+    """Show available credit balance."""
+    try:
+        client = await get_client(ctx)
+        balance = await client.get_credits()
+        await client.close()
+
+        print_success(
+            {"credits_available": balance},
+            quiet_value=str(balance),
+        )
+    except click.ClickException:
+        raise
+    except Exception as e:
+        print_error(str(e))
+        raise SystemExit(1)