{"id":47711247,"url":"https://github.com/os8ai/os8","last_synced_at":"2026-04-26T00:01:28.255Z","repository":{"id":347684121,"uuid":"1194886719","full_name":"os8ai/os8","owner":"os8ai","description":"A personal operating system for building custom web apps with AI agents","archived":false,"fork":false,"pushed_at":"2026-04-24T02:43:48.000Z","size":22932,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T04:27:33.933Z","etag":null,"topics":["ai","ai-agents","claude","desktop-app","developer-tools","electron","gemini","local-first","react","sqlite","tailwindcss","vite"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/os8ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-29T00:02:19.000Z","updated_at":"2026-04-24T02:43:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"29a33814-db01-49ca-b1c6-6c360e767501","html_url":"https://github.com/os8ai/os8","commit_stats":null,"previous_names":["os8ai/os8"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/os8ai/os8","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/os8ai%2Fos8","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/os8ai%2Fos8/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/os8ai%2Fos8/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/os8ai%2Fos8/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/os8ai","download_url":"https://codeload.github.com/os8ai/os8/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/os8ai%2Fos8/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32280981,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"ssl_error","status_checked_at":"2026-04-25T18:29:32.149Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","claude","desktop-app","developer-tools","electron","gemini","local-first","react","sqlite","tailwindcss","vite"],"created_at":"2026-04-02T18:32:29.872Z","updated_at":"2026-04-26T00:01:28.249Z","avatar_url":"https://github.com/os8ai.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OS8\n\n![How OS8 works](docs/images/os8-infographic.jpeg)\n\nA personal operating system for building custom web apps with AI agents. Everything local, everything yours.\n\nLearn more at [os8.ai](https://os8.ai)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"build/icon.png\" alt=\"OS8\" width=\"128\" /\u003e\n\u003c/p\u003e\n\n## What is OS8?\n\nOS8 is a desktop app where you create web applications with AI assistance — click \"New App,\" name it, and start building with an integrated AI terminal. No setup, no boilerplate, no cloud dependencies.\n\n- **One-click app creation** — React + Tailwind scaffolded instantly, live preview, hot reload\n- **Multi-backend AI** — Claude, Gemini, Codex, and Grok in an integrated terminal\n- **AI agents** — Custom agents with memory, scheduled jobs, voice, Telegram, and group chat\n- **Capabilities system** — APIs, skills, and MCP tools that agents can discover and use\n- **Local-first** — All your data stays on your machine in `~/os8/`\n\n## Download\n\nGet the latest release from [GitHub Releases](https://github.com/os8ai/os8/releases):\n\n- **macOS** — `.dmg` installer\n- **Windows** — `.exe` installer\n- **Linux** — `.AppImage`\n\nThe first launch walks you through setup — AI provider installation, credentials, voice, and account configuration.\n\n## Build from Source\n\nFor contributors and developers:\n\n```bash\ngit clone https://github.com/os8ai/os8.git\ncd os8\nnpm install\nnpx electron-rebuild -f -w better-sqlite3\nnpm start\n```\n\n**Requirements:** Node.js 22+ (LTS recommended). Supports macOS, Windows, and Linux.\n\nOS8 runs on port **8888** by default (configurable in Settings). Apps are served at `http://localhost:8888/{app-id}/`.\n\n## Features\n\n### App Development\n- Create React/Tailwind apps with one click\n- AI-powered terminal (Claude, Gemini, Codex, Grok)\n- Real-time preview with hot module replacement\n- Task management and file browser\n- Per-app SQLite databases and blob storage\n\n### AI Agents\n- Intelligent model routing across providers\n- 4-tier hierarchical memory (raw, session digests, daily digests, semantic search)\n- Subconscious memory processor with depth control\n- Timed jobs for scheduled tasks\n- Telegram messaging integration\n- Voice input/output (ElevenLabs + OpenAI TTS) and phone calls\n- Multi-agent group chat with moderator turn-taking\n- Life simulation (reverie, journal, portraits)\n\n### Capabilities\n- Unified system of APIs, skills, and MCP tools\n- Auto-discovered from routes, skill files, and MCP servers\n- Skill catalog with security review and quarantine\n- Google Calendar, Gmail, Drive, image generation, YouTube, and more\n\n## Tech Stack\n\n| Component | Technology |\n|-----------|------------|\n| Desktop shell | Electron |\n| App framework | React 18 + Tailwind CSS 3 |\n| Build tool | Vite 5 (middleware mode) |\n| Database | SQLite (better-sqlite3) |\n| Terminal | node-pty + xterm.js |\n| AI backends | Claude Code, Gemini CLI, Codex CLI, Grok CLI |\n\n## Project Structure\n\n```\nos8/\n├── main.js              # Electron main process\n├── index.html           # Renderer HTML shell\n├── preload.js           # IPC bridge\n├── src/\n│   ├── renderer/        # UI modules\n│   ├── ipc/             # IPC handlers\n│   ├── assistant/       # Agent services (memory, identity, messaging)\n│   ├── routes/          # Express API routes (30+)\n│   ├── services/        # Backend services (~60 modules)\n│   ├── shared/          # Modules shared between shell and apps\n│   ├── templates/       # App scaffolding templates\n│   ├── db.js            # Database initialization\n│   └── server.js        # Express + Vite server\n├── styles/              # Modular CSS\n├── skills/              # Built-in skill definitions\n├── tests/               # Unit tests (vitest)\n└── docs/                # Documentation\n```\n\n## User Data\n\nAll user data lives in `~/os8/` (override with `OS8_HOME` env var):\n\n| Directory | Purpose |\n|-----------|---------|\n| `apps/` | App source code (React/JSX) |\n| `config/` | SQLite database |\n| `blob/` | Per-app file storage |\n| `core/` | Shared React/Vite/Tailwind |\n| `skills/` | Installed skill definitions |\n\n## Documentation\n\n- **[OS8 Project Context.md](OS8%20Project%20Context.md)** — Architecture, philosophy, and data model\n- **[OS8-project-design-principles.md](OS8-project-design-principles.md)** — Code patterns and conventions\n- **[CLAUDE.md](CLAUDE.md)** — AI development reference (file locations, service index)\n\n## Community\n\nHave a question, idea, or something to show off? Join the [GitHub Discussions](https://github.com/os8ai/os8/discussions).\n\nSee [ROADMAP.md](ROADMAP.md) for where the project is headed and [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fos8ai%2Fos8","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fos8ai%2Fos8","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fos8ai%2Fos8/lists"}