> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fliiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install Fliiq and set up your environment

## Requirements

* **Python 3.12+** — Check with `python --version`
* **pip** — Comes with Python. Check with `pip --version`
* **An LLM API key** — At least one of: Anthropic, OpenAI, or Google Gemini (or a [self-hosted LLM](/guides/configuration#self-hosted-llms))

## Install from PyPI

```bash theme={null}
pip install fliiq
```

Verify the installation:

```bash theme={null}
fliiq --version
```

## Initialize

### Global setup (required)

```bash theme={null}
fliiq init
```

This creates `~/.fliiq/` with:

```
~/.fliiq/
  .env          # API keys template
  memory/       # Persistent memory files
  audit/        # Audit trails from agent runs
  skills/       # User-generated skills (available everywhere)
```

Edit `~/.fliiq/.env` and add at least one API key:

```bash .env theme={null}
ANTHROPIC_API_KEY=sk-ant-...
# OPENAI_API_KEY=sk-...
# GEMINI_API_KEY=...
```

### Project-specific setup (optional)

```bash theme={null}
cd my-project
fliiq init --project
```

This creates `.fliiq/` in your project directory with additional customization:

```
.fliiq/
  SOUL.md       # Agent personality overrides
  playbooks/    # Custom domain playbooks
  mcp.json      # MCP server connections
  memory/       # Project-specific memory
  audit/        # Project audit trails
  jobs/         # Scheduled job definitions
  skills/       # Project-specific skills
```

Project-level config takes priority over global config. This lets you customize the agent per-project without affecting your global setup.

**Resolution order:** project `.fliiq/` > global `~/.fliiq/` > bundled defaults.

## Optional Dependencies

Some skills require extra packages that aren't installed by default (to keep the base install lightweight):

| Extra     | Install command                | Skills enabled                                                                                    |
| --------- | ------------------------------ | ------------------------------------------------------------------------------------------------- |
| `browser` | `pip install "fliiq[browser]"` | `web_navigate` — browser automation via [browser-use](https://github.com/browser-use/browser-use) |
| `all`     | `pip install "fliiq[all]"`     | All optional skill dependencies                                                                   |

```bash theme={null}
pip install "fliiq[all]"               # Everything — all core skills work out of the box
pip install "fliiq[browser]"           # Just browser
pip install "fliiq[browser,dev]"       # Browser + dev tools
```

If you try to use a skill without its dependencies, the agent will tell you exactly what to install.

## Verify Setup

```bash theme={null}
fliiq doctor
```

`doctor` checks:

* API keys are set and valid
* SOUL.md is present
* Playbooks directory exists
* MCP servers are reachable (if configured)
* Skills directories are valid

Fix any issues it reports before running your first command.

## Development Install

If you're contributing to Fliiq or want to run from source:

```bash theme={null}
git clone https://github.com/fliiq/fliiq.git && cd fliiq
pip install -e ".[dev]"
fliiq init
```

This installs Fliiq in editable mode with dev dependencies (pytest, ruff, etc.).

## Upgrading

```bash theme={null}
pip install --upgrade fliiq
```

Your `~/.fliiq/` directory (memory, skills, jobs, config) is preserved across upgrades.