xmannii/

nimruz-desktop

GitHub

Nimruz Desktop is an open-source Persian AI workspace agent built with Electron, React, and the Vercel AI SDK. It supports agentic workspaces, local-first storage, and multiple provider integrations; available for Windows/macOS installers and Linux builds via pnpm dist.

19stars

2forks

1issues

MITlicense

2026since

Star historydaily snapshots by VibeCrowd

Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).

Reviewgenerated from repository data · Jul 18, 2026

What it is

Nimruz Desktop is an open-source Persian AI workspace agent for the desktop. Built with Electron, React, and the Vercel AI SDK. It connects Codex through various providers and offers tool-capable providers inside linked workspace folders, with local-first storage and approvals.

How it works

Agentic workspace functionality links project folders and provides workspaces with chats, tools, approvals, and artifacts stored locally.
Chat supports streaming, Markdown, code, math (KaTeX), RTL-first Persian UI; includes tool timeline and a Codex with ChatGPT sign-in integration.
Integrates OpenRouter and OpenAI-compatible providers; Codex runs in an isolated runtime. Local storage options include SQLite and OS keychain for API keys.
Architecture includes an Electron main process, a hardened local HTTP server for API endpoints, a SQLite database, workspace files, and a Codex app-server.

Getting started

Prerequisites:
- Node.js 22.12.0 or newer
- pnpm 9 or newer
Install and run:

git clone https://github.com/xmannii/nimruz-desktop.git
cd nimruz-desktop
pnpm install
pnpm dev

On first launch, complete onboarding, configure models/providers, and create or open a workspace.
Build a distributable:

pnpm dist

Release workflow builds Windows/macOS installers and creates a GitHub release when version bumps in package.json.

Recent releases

v1.0.2 Nimruz 1.0.2 (2026-07-18): Full Changelog: https://github.com/xmannii/nimruz-desktop/compare/v1.0.1...v1.0.2
v1.0.1 Nimruz 1.0.1 (2026-07-17): Full Changelog: https://github.com/xmannii/nimruz-desktop/compare/v1.0.0...v1.0.1
v1.0.0 Nimruz 1.0.0 (2026-07-17): Integrate Codex with agentic workspaces by @yappologistic in https://github.com/xmannii/nimruz-desktop/pull/4
v0.3.1 Nimruz 0.3.1 (2026-07-16): Full Changelog: https://github.com/xmannii/nimruz-desktop/compare/v0.3.0...v0.3.1
v0.3.0 Nimruz 0.3.0 (2026-07-16): Full Changelog: https://github.com/xmannii/nimruz-desktop/compare/v0.2.0...v0.3.0

Traction

Stars: 19
Forks: 2
Open issues: 1

License

MIT

Local data and storage

Application data lives in Electron's platform-specific userData directory (Nimruz) as nimruz.sqlite3.
Codex state stored in codex/ and codex-workspace/; credentials stored in OS credential store.
Skills stored under ~/.nimruz/skills; workspace-linked folders stay on disk at their pointed locations.

SharePost on X LinkedIn