# FyodorOS
[![Version](https://img.shields.io/badge/version-v0.8.0-blue.svg)](https://github.com/Kiy-K/FyodorOS/releases)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

```
███████╗██╗   ██╗ ██████╗ ██████╗  ██████╗ ██████╗
██╔════╝╚██╗ ██╔╝██╔═══██╗██╔══██╗██╔═══██╗██╔══██╗
█████╗   ╚████╔╝ ██║   ██║██║  ██║██║   ██║██████╔╝
██╔══╝    ╚██╔╝  ██║   ██║██║  ██║██║   ██║██╔══██╗
██║        ██║   ╚██████╔╝██████╔╝╚██████╔╝██║  ██║
╚═╝        ╚═╝    ╚═════╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═╝
          The Experimental AI Microkernel
```

**FyodorOS** is a local-first AI Operating System that runs on your metal. Unlike traditional OSs designed for humans (GUI/CLI) or servers (API), FyodorOS exposes the entire system state as a **Document Object Model (DOM)**, allowing Agents to "perceive" and interact with the kernel natively.

## 🚀 Vision

We believe that for AI Agents to be truly useful and safe, they need an environment built for them. FyodorOS provides:
*   **Structured Observation**: The OS state (Filesystem, Processes, Users) is a queryable DOM tree.
*   **Cognitive Loop**: Built-in ReAct (Reasoning + Acting) loop at the kernel level.
*   **Safety Sandbox**: A strict, rule-based verification layer that constraints Agent actions before execution.
*   **Agent-Native Apps**: Standard tools (`browser`, `explorer`, `calc`) that return structured JSON/DOM instead of plain text, minimizing token usage and parsing errors.
*   **Cloud Integration (v0.5.0)**: Native Docker and Kubernetes support.
*   **Long-Term Memory (v0.7.0)**: Persistent semantic storage allowing agents to learn and recall information.
*   **Desktop Interface (v0.8.0)**: A native desktop application bridging the Python kernel with a modern React UI.

## 📦 Installation

### Option A: User (Recommended)
Download the installer for Windows, Mac, or Linux from the [Releases](https://github.com/Kiy-K/FyodorOS/releases) page.

### Option B: Developer (Legacy/Headless)
You can install FyodorOS as a Python package for headless or CLI-only usage.

```bash
pip install fyodoros
playwright install chromium
```

## 🛠️ Development

To build the full Desktop experience from source, you need Node.js, Rust, and Python installed.

1.  **Clone the Repository**
    ```bash
    git clone https://github.com/Kiy-K/FyodorOS.git
    cd fyodoros
    ```

2.  **Install Frontend Dependencies**
    ```bash
    cd gui
    npm install
    ```

3.  **Run in Development Mode**
    ```bash
    npm run tauri dev
    ```

## 🏗️ Architecture

FyodorOS v0.8.0 adopts a hybrid architecture to combine the flexibility of Python AI libraries with the performance and native capabilities of Rust.

```mermaid
graph LR
    User[User] <--> React[React UI (Shadcn)]
    React <--> Tauri[Tauri (Rust Sidecar)]
    Tauri <--> Nuitka[Nuitka (Compiled Python Kernel)]
    Nuitka <--> System[Host System (Sandboxed)]
```

*   **React UI**: A modern web-based interface for visualizing the OS state and Agent actions.
*   **Tauri**: Handles window management and communicates with the Python kernel via a sidecar protocol.
*   **Nuitka Kernel**: The Python core compiled into a standalone binary for performance and security, running the Agent loop and managing system resources.

## 🤝 Contributing

FyodorOS is an experimental sandbox. We welcome contributions to:
- Expand the standard library of Agent Apps.
- Improve the DOM representation of system state.
- Implement more complex Sandbox rules.

---
*Built for the future of Autonomous Computing.*

[![Star History](https://api.star-history.com/svg?repos=Kiy-K/FyodorOS&type=Date)](https://star-history.com/#Kiy-K/FyodorOS&Date)
