# Friday Os

> Voice-first, memory-persistent, MCP-powered personal AI OS. CLI + LiveKit voice + Tauri desktop + Claude Code plugin. Runs offline on Ollama or cloud via Anthropic.

- **Type:** MCP server
- **Install:** `agentstack add mcp-sahiixx-friday-os`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sahiixx](https://agentstack.voostack.com/s/sahiixx)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [sahiixx](https://github.com/sahiixx)
- **Source:** https://github.com/sahiixx/friday-os

## Install

```sh
agentstack add mcp-sahiixx-friday-os
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# FRIDAY OS — Voice-First AI Operating System

> **A voice-first, memory-persistent, MCP-powered personal AI OS.**  
> PERCEIVE → ROUTE → PLAN → EXECUTE → SYNTHESIZE — with your voice.

[](https://livekit.io)
[](https://ollama.com)
[](tests/)
[](LICENSE)

---

## The Pitch

**Siri** answers weather. **Alexa** sets timers. **FRIDAY** builds your startup.

FRIDAY OS is a voice-first AI operating system that:
- 🎙️ **Listens** — LiveKit real-time voice pipeline (STT → Brain → TTS)
- 🧠 **Thinks** — PERCEIVE → ROUTE → PLAN → EXECUTE → SYNTHESIZE
- 💾 **Remembers** — Persistent memory across sessions (integrates with `titans-memory`)
- 🔧 **Acts** — Tool registry with web search, code execution, shell, file I/O
- 🏗️ **Delegates** — Multi-step planning with dependency resolution
- 🎭 **Adapts** — Loads your persona from `~/.openjarvis/{SOUL,USER,MEMORY}.md`

All local. All private. No cloud required.

---

## One-Command Start

```bash
# Clone and install
git clone https://github.com/sahiixx/friday-os.git
cd friday-os
pip install -e ".[voice]"

# Start FRIDAY (console mode — no voice deps needed)
python -m friday.cli

# Or start voice agent (requires LiveKit + Ollama)
python -m friday.voice.agent_friday console
```

---

## Architecture

```
┌─────────────────────────────────────────────────────────────┐
│  🎙️ Voice Layer (LiveKit Agents SDK)                        │
│   ├── Silero VAD (voice activity detection)                 │
│   ├── OpenAI Whisper STT (or local equivalent)              │
│   └── OpenAI TTS (or local equivalent)                     │
├─────────────────────────────────────────────────────────────┤
│  🧠 FRIDAY Brain                                             │
│   ├── Router — intent classification (heuristic + LLM)      │
│   ├── Planner — multi-step plan with dependency resolution  │
│   ├── Orchestrator — PERCEIVE→ROUTE→PLAN→EXECUTE→SYNTHESIZE│
│   └── Memory — persona + episodic + titans-memory           │
├─────────────────────────────────────────────────────────────┤
│  🔧 Tool Registry                                            │
│   ├── search_web — DuckDuckGo                               │
│   ├── run_code — Python sandbox                             │
│   ├── shell_exec — gated shell access                       │
│   ├── memory_save / memory_recall — persistent storage      │
│   └── file_read / file_write — file I/O                     │
├─────────────────────────────────────────────────────────────┤
│  🦙 LLM Provider (pluggable)                                 │
│   ├── Claude (API)                                          │
│   ├── OpenAI (API)                                          │
│   └── Ollama (local) — qwen2.5-coder, llama3.1, etc.       │
└─────────────────────────────────────────────────────────────┘
```

---

## How It Works

### 1. Router — What do you want?

```python
# Heuristic classification (zero-cost fast path)
"Search for latest AI news"        → RESEARCH
"Calculate 2^128"                 → ANALYTICAL
"Write a poem about recursion"    → CREATIVE
"Build a Chrome extension"        → AGENTIC (requires planning)
"Hello"                           → CONVERSATIONAL
```

If confidence  *"The future of AI isn't a chatbot. It's an operating system that listens, thinks, and acts — and never forgets."*

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sahiixx](https://github.com/sahiixx)
- **Source:** [sahiixx/friday-os](https://github.com/sahiixx/friday-os)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-sahiixx-friday-os
- Seller: https://agentstack.voostack.com/s/sahiixx
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.