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

# Introduction

> The AI agent that builds itself and that you own!

Fliiq is an AI agent that evolves. Install it via `pip`, and it comes with 57 built-in skills — but when it hits a capability gap, it researches the API, writes the skill, and uses it mid-conversation. Email, calendar, Slack, Discord, WhatsApp, Telegram, GitHub, Notion, weather, image generation, browser automation, scheduled jobs, persistent memory, institutional knowledge — all from your terminal, all on your machine.

## Quick Example

```bash theme={null}
pip install fliiq
fliiq init
fliiq run "build a Flask todo app with SQLite"
```

Fliiq decomposes the task, creates files, installs dependencies, starts the dev server, and verifies everything works — all in one command.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Install and run your first command in 5 minutes.
  </Card>

  <Card title="Self-Generating Skills" icon="wand-magic-sparkles" href="/skills/self-generating">
    See how Fliiq built its own Spotify integration from scratch.
  </Card>
</CardGroup>

## Why Fliiq?

<CardGroup cols={3}>
  <Card title="It evolves" icon="bolt">
    When Fliiq can't do something, it researches the API, writes the skill, and uses it — right in the conversation. Your agent gets more capable every time you use it.
  </Card>

  <Card title="It learns" icon="brain">
    Persistent memory across sessions. After each conversation, Fliiq extracts people, topics, and decisions into structured memory files — and runs a lessons loop that captures behavioral corrections and procedures, injecting them into the next session's prompt so it gets better every time you use it.
  </Card>

  <Card title="You own it" icon="lock">
    Runs locally. Your API keys, your data. No cloud lock-in, no subscription to a platform you don't control.
  </Card>
</CardGroup>

## Capabilities

<CardGroup cols={2}>
  <Card title="File Operations" icon="file">
    Read, write, edit, list, grep, and find files across your codebase.
  </Card>

  <Card title="Shell & Dev Server" icon="terminal">
    Run commands, install dependencies, start and manage dev servers.
  </Card>

  <Card title="Web Search, Fetch & Navigate" icon="globe">
    Search the web, fetch page content, and automate browsers — fill forms, extract data, and interact with web pages.
  </Card>

  <Card title="Persistent Memory" icon="database">
    Curated MEMORY.md loaded every session. After each conversation, Fliiq auto-extracts people, topics, and decisions into structured memory files. Daily logs and keyword search across all memory files.
  </Card>

  <Card title="Self-Generating Skills" icon="wand-magic-sparkles">
    Agent detects capability gaps, researches APIs, and builds new skills autonomously.
  </Card>

  <Card title="Email, SMS, Messaging & Voice" icon="envelope">
    Give Fliiq its own Gmail, Telegram bot, and Twilio number. Send and receive via Slack, Discord, and WhatsApp. Voice calls via Twilio. Send voice notes to the bot — it transcribes and responds. Text-to-speech for Mandarin and English (`text_to_speech`) and native Cantonese TTS with accurate tonal pronunciation (`cantonese_tts`). Email threading (CC, BCC, reply chains) and a daemon email listener that polls your inbox automatically.
  </Card>

  <Card title="Daemon & Scheduled Jobs" icon="clock">
    Background process runs cron, interval, and webhook-triggered automations with per-job memory.
  </Card>

  <Card title="Google Workspace" icon="file-spreadsheet">
    Drive, Sheets, Docs, and Slides — all via OAuth. Manage files, build spreadsheets, draft documents, and create presentations.
  </Card>

  <Card title="MCP Integration" icon="plug">
    Connect any MCP server and its tools are available alongside built-in skills.
  </Card>

  <Card title="Personas & Identity" icon="user-pen">
    Run as a product manager, frontend dev, or coder. SOUL.md defines personality. Playbooks add domain expertise. Create your own.
  </Card>

  <Card title="Multi-LLM Support" icon="microchip">
    Anthropic, OpenAI, Gemini, and self-hosted LLMs. Switch providers per-command or set a persistent default.
  </Card>

  <Card title="Colony — Multi-Agent Mode" icon="users">
    Give Fliiq a mission and five specialized agents (Intelligence, Research, Scout, QA, Governance) collaborate to deliver results. Run with `fliiq colony start --mission "your objective"`.
  </Card>
</CardGroup>
