Cipher OS // Local-First Concurrent AI Runtime

## Prerequisites

- Windows 10/11

- Python 3.11+

- Ollama installed and running

- Git

## Clone the repository

```bash

git clone https://github.com/mohamad-shafeez/Cipher-AI.git

cd Cipher-AI

```

## Create a virtual environment

```bash

python -m venv venv

```

Activate it:

```bash

venv\Scripts\activate

```

## Install dependencies

```bash

pip install -r requirements.txt

```

## Install and start Ollama

Download Ollama and pull the required models.

Example:

```bash

ollama pull llama3

```

## Configure environment

Create a `.env` file and add any required API keys or configuration values.

## Run Cipher OS

```bash

python main.py

```

The runtime will initialize workers, memory, telemetry, and voice services automatically.

After launching Cipher OS:

1. Start the application.

2. Activate voice interaction using the configured hotkey.

3. Speak naturally to interact with the local AI.

4. Switch between lightweight and advanced inference modes when needed.

5. Monitor worker status, CPU/RAM usage, and runtime events through the Telemetry Dashboard.

6. Use built-in skills such as automation, document analysis, vision, and developer tools.

7. Extend functionality by adding new skill modules to the plugin system.

Cipher OS runs locally and is designed to continue operating even if background workers fail, automatically recovering them through the watchdog system.

Operating System

- Windows 10 or Windows 11

Runtime

- Python 3.11+

- Ollama

Recommended Hardware

- Quad-core CPU or better

- 16 GB RAM (8 GB minimum)

- SSD Storage

- Microphone for voice interaction

Optional

- NVIDIA GPU for faster local inference

Software

- Git

- Visual Studio Code (recommended)