git404hub

what is nimruz-desktop fr?

xmannii/nimruz-desktop — explained in plain English

Analysis updated 2026-05-18

45TypeScriptAudience · vibe coderComplexity · 2/5Setup · moderate

tl;dr

An open-source Persian-language desktop AI workspace agent that can chat, read and edit project files, and run tools with your approval.

vibe map

mindmap
  root((repo))
    What it does
      Persian AI chat
      Workspace file agent
    Tech stack
      Electron
      React
      TypeScript
    Providers
      Codex via ChatGPT
      OpenRouter
    Use cases
      Local AI assistant
      In-folder coding help
    Audience
      Vibe coders
      Persian speakers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Chat with an AI assistant in a Persian right-to-left desktop interface

VIBE 2

Let an AI agent read, search, and edit files inside a linked project workspace

VIBE 3

Use a ChatGPT account to access OpenAI's Codex model inside a desktop app

VIBE 4

Save reusable experts, skills, and memories for recurring assistant tasks

what's the stack?

TypeScriptElectronReactSQLite

how it stacks up fr

xmannii/nimruz-desktopi4w7w4a/liquid_prnc_glassqunabu/gravity
Stars454545
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity2/53/53/5
Audiencevibe coderdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

macOS builds are unsigned, so Gatekeeper may block first launch until you allow it manually.

The README does not state a license for the project.

in plain english

Nimruz Desktop is an open-source desktop app that gives you a chat assistant with a Persian, right-to-left interface, built for people who want to work with AI language models directly on their own files rather than only chatting in a browser tab. It is built with Electron, React, and the Vercel AI SDK, and works on Windows and macOS, with Linux support available if you build it yourself. Beyond plain chat, Nimruz can act as a workspace agent: you link a project folder, and the assistant can read, search, and write files, run shell commands, and produce artifacts and tasks inside that folder, asking for your approval before anything risky runs. You can connect it to a ChatGPT account to use OpenAI's Codex model, or bring your own key through OpenRouter or another compatible provider. When using Codex through a ChatGPT sign-in, the app runs it with a restricted setup that limits which files it can touch and blocks network access and several other tool types for safety. Other features include reusable saved experts and skills you can call up while chatting, a memory system that lets the assistant save and later forget specific facts, streaming responses with support for code, math, and diagrams, and light, dark, and system color themes. Everything is stored locally on your machine in an SQLite database, and provider API keys are kept in your operating system's secure keychain rather than in a plain text file. To try it from source you need Node.js version 22.12 or newer and the pnpm package manager, then you clone the repository, run pnpm install, and start it with pnpm dev. Pre-built installers for Windows and macOS are also published with each release, though the macOS build is not yet signed or notarized, so macOS may initially warn that the app looks damaged. The README does not state a software license for the project.

prompts (copy fr)

prompt 1
Install Nimruz Desktop from source using pnpm and run it in dev mode
prompt 2
Connect my ChatGPT account to use Codex inside Nimruz
prompt 3
Link a project folder as a workspace so the agent can edit its files
prompt 4
Set up OpenRouter as a model provider in Nimruz's settings
prompt 5
Explain what approvals and artifacts mean in Nimruz's agentic workspace

Frequently asked questions

what is nimruz-desktop fr?

An open-source Persian-language desktop AI workspace agent that can chat, read and edit project files, and run tools with your approval.

What language is nimruz-desktop written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, React.

What license does nimruz-desktop use?

The README does not state a license for the project.

How hard is nimruz-desktop to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is nimruz-desktop for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.