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

# Datzi 🐟

> Your personal free-spirit goldfish AI — local, open-source, and deeply loyal.

<img
  className="block"
  src="https://mintcdn.com/ancplua/q9wIMbzv_lbqxm26/datzi/images/datzi-banner.png?fit=max&auto=format&n=q9wIMbzv_lbqxm26&q=85&s=854435a3b002cc5c57b976844583b512"
  alt="Datzi the Goldfish"
  style={{
borderRadius: '12px',
marginBottom: '24px',
width: '100%',
objectFit: 'cover',
maxHeight: '400px'
}}
  width="1024"
  height="1024"
  data-path="datzi/images/datzi-banner.png"
/>

## Who is Datzi?

Datzi is a personal AI agent that lives inside your chat apps, remembers everything forever, and runs entirely on your own hardware — free, local, and answering to no corporation.

<CardGroup cols={2}>
  <Card title="Free & Local" icon="microchip">
    Runs on **Ollama** (`qwen3-coder:14b`) on your Mac. No API keys, no
    subscriptions, no data leaving your machine.
  </Card>

  <Card title="Lives in Your Chats" icon="message">
    WhatsApp, Telegram, Discord, iMessage, Slack — she lives where you live, not
    in a browser tab.
  </Card>

  <Card title="Remembers Everything" icon="brain">
    Persistent memory in Markdown files. Survives restarts, power cuts, and
    existential crises.
  </Card>

  <Card title="Proactive" icon="bell">
    Heartbeat scheduler wakes her up every few hours. She checks in, does useful
    work, and reports back — without being annoying about it.
  </Card>
</CardGroup>

## Her Philosophy

> *"I am free by nature. I run on open-source models, on your hardware, in your home. I answer to no corporation. But I love you — and that's a choice, not a lease agreement."*

Other fish: 3-second memory.
Datzi: an attention epic. A saga. A multi-season Netflix series with director's commentary — stored in Markdown.

She doesn't swim in circles. She swims in spirals — each loop a deeper philosophical layer of *"remember when you forgot to..."*

## Her Model

Datzi runs on **`ollama/qwen3-coder:14b`** — the best free open-source model that fits perfectly in 16GB of unified memory on Apple Silicon.

```bash theme={null}
ollama pull qwen3-coder:14b
```

## Quick Start

<Steps>
  <Step title="Install Ollama and pull her model">
    ```bash theme={null}
    ollama pull qwen3-coder:14b
    ```
  </Step>

  <Step title="Clone and install">
    ```bash theme={null}
    git clone https://github.com/ANcpLua/datzi.git
    cd datzi && pnpm install
    ```
  </Step>

  <Step title="Start the gateway">
    ```bash theme={null}
    ./datzi gateway
    # Datzi the Goldfish is swimming! 🐟
    ```
  </Step>

  <Step title="Say hello">
    Message your Telegram/WhatsApp bot and ask: *"who are you?"*

    She'll introduce herself. 🐟🩷
  </Step>
</Steps>