Installation

Install and configure Anysite CLI

Installation

One-Line Installer

The fastest way to install — no Python or Homebrew required (macOS / Linux):
```bash
curl -fsSL https://raw.githubusercontent.com/anysiteio/anysite-cli/main/install.sh | bash
```
This installs all extras by default (datasets, LLM, PostgreSQL, ClickHouse). Options:
```bash
# Minimal install (no optional dependencies)
curl -fsSL https://raw.githubusercontent.com/anysiteio/anysite-cli/main/install.sh | bash -s -- --extras none

# Upgrade existing installation
curl -fsSL https://raw.githubusercontent.com/anysiteio/anysite-cli/main/install.sh | bash -s -- --upgrade

# Uninstall
curl -fsSL https://raw.githubusercontent.com/anysiteio/anysite-cli/main/install.sh | bash -s -- --uninstall
```

Homebrew

```bash
brew tap anysiteio/cli https://github.com/anysiteio/anysite-cli
brew install anysite
```

pip

```bash
pip install anysite-cli
```

  Requires **Python 3.11** or higher.

From Source

```bash
git clone https://github.com/anysiteio/anysite-cli.git
cd anysite-cli
python -m venv .venv
source .venv/bin/activate
pip install -e .
```

Optional Extras

Install additional capabilities based on your needs:

Package	Command	What It Adds
Data	pip install "anysite-cli[data]"	DuckDB + PyArrow for dataset pipelines and SQL querying
LLM	pip install "anysite-cli[llm]"	LLM analysis with OpenAI and Anthropic models
PostgreSQL	pip install "anysite-cli[postgres]"	PostgreSQL database adapter
ClickHouse	pip install "anysite-cli[clickhouse]"	ClickHouse database adapter
All	pip install "anysite-cli[all]"	All optional dependencies

Verify Installation

anysite --version

Configuration

Set Your API Key

Get your API key from app.anysite.io and configure it:

anysite config set api_key YOUR_API_KEY

Update Schema Cache

The schema cache enables endpoint discovery and automatic type conversion:

anysite schema update

Configuration Management

# View all settings
anysite config list

# Get a specific setting
anysite config get api_key

# Set a value
anysite config set api_key sk-xxxxx

# Show config file path
anysite config path

# Reset to defaults
anysite config reset

Configuration Priority

Settings are resolved in this order (highest priority first):

1. CLI flags — --format csv, --parallel 5
2. Environment variables — ANYSITE_API_KEY
3. Config file — ~/.anysite/config.yaml
4. Defaults — built-in default values

Use environment variables for CI/CD environments and the config file for local development.

Claude Code Skill

Install the anysite-cli skill for Claude Code to get AI-assisted data collection directly in your terminal:

Add the skills marketplace

```bash
/plugin marketplace add https://github.com/anysiteio/agent-skills
```

Install the skill

```bash
/plugin install anysite-cli@anysite-skills
```

The skill gives Claude Code full knowledge of all anysite commands, dataset pipeline configuration, database operations, and LLM analysis — so you can describe what data you need in natural language and let the agent build and run the pipeline for you.

Global Options

These options are available for all commands:

anysite [OPTIONS] COMMAND

Options:
  --api-key TEXT       API key (or set ANYSITE_API_KEY)
  --base-url TEXT      API base URL
  --debug              Enable debug output
  --no-color           Disable colored output
  --json               Force JSON output (even in terminal)
  --human              Force human-readable output (even in pipes)
  --non-interactive    Disable interactive prompts
  --version, -v        Show version
  --help               Show help

The --json and --human flags control Agent Protocol output mode. By default, the CLI auto-detects: JSON in pipes, human-readable in terminals.

Troubleshooting

Command not found: anysite

Make sure the Python scripts directory is in your `PATH`. If you installed in a virtual environment, activate it first:
```bash
source .venv/bin/activate
```
Or install globally:
```bash
pip install --user anysite-cli
```

Python version error

Anysite CLI requires Python 3.11+. Check your version:
```bash
python3 --version
```
Consider using [pyenv](https://github.com/pyenv/pyenv) to manage multiple Python versions.

Schema update fails

If `anysite schema update` fails, check your API key and network connection:
```bash
anysite config get api_key
curl -s https://api.anysite.io/openapi.json | head -c 100
```

Permission denied on install

Use a virtual environment or the `--user` flag:
```bash
python -m venv .venv && source .venv/bin/activate
pip install anysite-cli
```

Next Steps

Discover Endpoints

Browse and search 118+ available API endpoints

Make API Calls

Start extracting data with single API requests