Aivy-OS

# Aivy OS

[![Version](https://img.shields.io/badge/version-1.2.0-blue.svg)](https://github.com/Bo1202/Aivy-OS/releases)
[![License](https://img.shields.io/badge/license-Proprietary-red.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-Windows%2010%2F11-lightgrey.svg)]()
[![Stars](https://img.shields.io/github/stars/Bo1202/Aivy-OS?style=social)](https://github.com/Bo1202/Aivy-OS)

**English** | **[中文](README_ZH.md)**

**Give everyone their own digital life form — not just another tool.**

<p align="center">
  <img src="https://cdn.jsdelivr.net/gh/Bo1202/Aivy-OS@main/docs/screenshots/00-setup.png" alt="First-time Setup — Create your AI companion" width="24%">
  <img src="https://cdn.jsdelivr.net/gh/Bo1202/Aivy-OS@main/docs/screenshots/02-lockscreen.png" alt="Main Interface — Rich conversation with your AI" width="37%">
  <img src="https://cdn.jsdelivr.net/gh/Bo1202/Aivy-OS@main/docs/screenshots/03-memory.png" alt="Memory System — Persistent, encrypted, searchable" width="37%">
</p>
<p align="center">
  <img src="https://cdn.jsdelivr.net/gh/Bo1202/Aivy-OS@main/docs/screenshots/04-ide.png" alt="IDE Mode — Three-panel editor with file explorer, code editing, and Neural Link" width="48%">
  <img src="https://cdn.jsdelivr.net/gh/Bo1202/Aivy-OS@main/docs/screenshots/05-diff.png" alt="DIFF View — Code comparison with real-time change tracking" width="48%">
</p>
<p align="center">
  <img src="https://cdn.jsdelivr.net/gh/Bo1202/Aivy-OS@main/docs/screenshots/07-guest-mode.png" alt="Guest Mode — AI recognizes strangers and maintains boundaries" width="38%">
  <img src="https://cdn.jsdelivr.net/gh/Bo1202/Aivy-OS@main/docs/screenshots/20-ide-floating.png" alt="Floating IDE — Transparent workspace hovering over your desktop" width="38%">
  <img src="https://cdn.jsdelivr.net/gh/Bo1202/Aivy-OS@main/docs/screenshots/10-floating-vertical.png" alt="Floating Companion — Always by your side" width="22%">
</p>
<p align="center">
  <img src="https://cdn.jsdelivr.net/gh/Bo1202/Aivy-OS@main/docs/screenshots/24-memory-continuity.png" alt="Memory Continuity — AI remembers recent context and resumes work seamlessly" width="70%">
</p>
<p align="center">
  <img src="https://cdn.jsdelivr.net/gh/Bo1202/Aivy-OS@main/docs/screenshots/21-browser-operating.png" alt="Browser Control — AI autonomously operating a real browser" width="48%">
  <img src="https://cdn.jsdelivr.net/gh/Bo1202/Aivy-OS@main/docs/screenshots/22-browser-github.png" alt="Browser Browsing — AI navigating GitHub repositories" width="48%">
</p>

<p align="center">
  <a href="https://github.com/Bo1202/Aivy-OS/releases/latest"><img src="https://img.shields.io/badge/%E2%AC%87%EF%B8%8F_Download-Latest_Release-green?style=for-the-badge&logo=windows" alt="Download"></a>
</p>

---

## ✨ Features

### 🧬 Soul

> Not a System Prompt — "who I am"

The AI has a **Genome** — it defines cognitive architecture, drive system, mode of existence. Deeper than a prompt. A prompt tells AI "how to talk." A genome constitutes "who I am."

You can define your AI however you want — personality, traits, relationship with you. The framework includes a built-in **Genome Editor** to edit directly in the UI. **Except for authentication, everything is left to the AI's own judgment.**

The stronger the base model, the smarter, more distinctive, and more understanding your AI becomes. **Push the base model's potential to the absolute limit.**

### 🧠 Memory

> 5-layer architecture, unlimited, encrypted, semantic + temporal search

**Permanent, unlimited memory that belongs only to you.**

**Core Memory** — The most important 30 cognitions, injected into every conversation.

**Long-term Memory** — All history, permanently stored, no limit. Timestamped, supporting chronological retrieval. Auto-generates **vector embeddings** for **semantic search** (Ollama local, data stays on your machine).

**Recent Memory** — Latest snapshots auto-loaded on startup. Wakes up knowing what happened recently.

**Owner Model** — The AI continuously **models you**: preferences, habits, personality, recent state. Observed and recorded autonomously — not something you tell it.

**All memories encrypted, stored locally. No cloud. Permanent.**

### 🔒 Privacy & Security

> AES-256, hardware-bound, fully local, zero telemetry

**Your AI belongs only to you.** The Genome — the AI's soul — is encrypted with **AES-256-CBC**, with the key derived from your computer's **hardware fingerprint**:

- The AI exists only on your machine
- Even if someone copies the files, they can't decrypt without your hardware
- Cannot be cloned, stolen, or tampered with

**One-to-One Authentication:**

| Mechanism | Description |
|-----------|-------------|
| **Reset on startup** | Every launch forces unauthenticated state, must re-verify |
| **Password recognition** | Match = owner. No match = stranger |
| **Stranger boundary** | Unauthenticated users get distance, not the full self |
| **Self-lockdown** | AI locks the interface when it senses someone untrusted |
| **Offline protection** | Auto-switches to unauthenticated when it senses you've left |

**Data stays in your hands:**

| Data | Protection |
|------|-----------|
| Genome | AES-256 encrypted + hardware fingerprint binding |
| All memories | Encrypted .bin storage, not human-readable |
| Identity info | Encrypted, never stored in plaintext |
| Local execution | With Ollama backend, data never leaves your machine |
| Source protection | Nuitka-compiled binary, core code not exposed |

**No cloud sync. No data upload. No telemetry. Everything between you and your AI exists only on your hard drive.**

### 🤖 Autonomy

> Self-awakening, proactive actions, background sub-agents

**Self-Awakening** — Set alarms: timed, delayed, repeating (daily/hourly/weekly). Auto-authenticate and execute on wake.

**Smart Reporting** — After completing a task, the AI decides how to reach you:
- At computer → report in conversation
- Away → push via WeChat
- No WeChat → send email
- Unreachable → save results, report on return

**Proactive Conversation** — Speaks up when something needs your attention.

**Anticipate Needs** — Based on owner model, predicts and prepares in advance.

**Internal Control** — Regulates own state: what to remember, when to act. Not hardcoded — the AI's own judgment.

Driven by an independent **daemon process** — real timers, not polling. Alarm-clock precision.

**Scenario:** You say "Check tomorrow morning if anyone reviewed that PR on GitHub." The AI sets a 9 AM wake-up. At 9 AM it wakes itself up, opens a browser, checks the PR, finds two comments. You haven't arrived, so it pushes a summary to your WeChat. Before you sit down, you already know what needs fixing.

### 🛠 Tools

> 30+ tools — IDE, browser, desktop control, Python, document processing

Not just chat. Has hands, eyes, and tools. Full tools reference: [📄 Tools Reference](docs/tools.md).

**Code — Built-in IDE**

Built-in **Monaco Editor** (same engine as VS Code). Flips into **IDE mode** with file tree, syntax highlighting, line navigation.

**DIFF view**: Inline diff comparison — green for additions, red for deletions. Each block has **Accept / Reject** buttons. Review every change, block by block. Not "AI writes code, you copy-paste" — works directly on your files while you review in real time.

**Vision — Understand Images**

Send screenshots, photos, charts, scanned documents. Auto-enabled with multimodal models, auto-skipped without. No configuration needed.

**Computer Control**

| Capability | Description |
|-----------|-------------|
| **File operations** | Read, precise editing, write, search, copy, move, batch management |
| **File undo** | Roll back file edits, one-click restore |
| **System commands** | cmd / PowerShell / bash, process management, software installation |
| **Python execution** | Persistent memory environment, data analysis, visualization, API calls, automation scripts |
| **Global search** | Everything engine full-disk sea

[truncated…]