Skip to main content

​
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)

​
Install from PyPI

pip install fliiq
Verify the installation: 
fliiq --version

​
Initialize

​
Global setup (required)

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:
.env
ANTHROPIC_API_KEY=sk-ant-...
# OPENAI_API_KEY=sk-...
# GEMINI_API_KEY=...

​
Project-specific setup (optional)

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):
ExtraInstall commandSkills enabled
browserpip install "fliiq[browser]"web_navigate — browser automation via browser-use
allpip install "fliiq[all]"All optional skill dependencies
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

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: 
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

pip install --upgrade fliiq
Your ~/.fliiq/ directory (memory, skills, jobs, config) is preserved across upgrades.