explaingit

sthamann/nyx-local-ai

Analysis updated 2026-05-18

249TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A local-first AI coding agent extension for VS Code and Cursor that runs on your own hardware through Ollama, LM Studio, or similar tools, with zero per-token cost.

Mindmap

mindmap
  root((Nyx))
    What it does
      Local AI coding agent
      Diff approval cards
      Multi-machine manager
    Tech stack
      TypeScript
      VS Code extension
      Ollama and LM Studio
    Use cases
      Offline coding assistant
      Run own GPU fleet
      Private code edits
    Audience
      Developers
      Privacy-focused users

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 build with it?

USE CASE 1

Run a Cursor-style AI coding agent fully offline using your own local models.

USE CASE 2

Manage and route requests across multiple local machines running different AI models.

USE CASE 3

Review every proposed code change as a diff before it is applied.

USE CASE 4

Queue up several coding tasks to run overnight and get a summary report.

What is it built with?

TypeScriptVS CodeOllamaLM Studiollama.cpp

How does it compare?

sthamann/nyx-local-aidirenv/direnv-vscoderobinhood-ape/robinhood-noxa-bundler
Stars249250250
LanguageTypeScriptTypeScriptTypeScript
Last pushed2024-12-04
MaintenanceStale
Setup difficultymoderatemoderatemoderate
Complexity3/52/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a local model already running via Ollama, LM Studio, or a similar OpenAI-compatible server.

The provided excerpt does not state the license terms.

In plain English

Nyx is a coding assistant extension for VS Code and Cursor that runs entirely on your own computer or your own local network, instead of sending your code to a cloud AI service. It gives you a chat style agent panel that can read your codebase, propose file edits as reviewable diffs, and act on approved changes, similar to the built in agents in Cursor, but without any account, telemetry, or per message billing. The extension connects to AI models you are already running locally through tools like Ollama, LM Studio, or llama.cpp, or to a fleet of your own machines such as a Mac Studio or a GPU workstation exposing an OpenAI compatible endpoint. Nyx calls this a machine manager: it can talk to several of your own machines at once, automatically discover which models are available on each one, detect what each model supports, and switch to another machine if one becomes unavailable. A large part of the project's design goes into making these local, sometimes smaller or less capable models behave reliably as agents. It works to recover tool calls even when a model's output is messy or doesn't format things the expected way, repairs malformed responses, matches file edits loosely so whitespace differences don't break them, and gives weaker models a simpler set of available tools. On top of that, it offers approval cards that show you a diff before anything is applied, checkpoints you can edit and rerun, a job queue for running multiple tasks in sequence, project memory, and a privacy report button that lists every outside address the session actually contacted during use. Getting started is meant to be simple: once installed, Nyx detects models you already have running locally, and if something is missing, like Ollama not running or no coding model installed, it walks you through fixing that with one click. It is meant to sit alongside, not replace, a cloud based agent such as Cursor's own, so you can use the cloud agent for harder problems and Nyx for everyday work that should stay on your own hardware. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Walk me through installing Nyx in VS Code and connecting it to a local Ollama model.
Prompt 2
Explain how Nyx's machine manager handles failover between multiple local AI hosts.
Prompt 3
How does Nyx recover from a local model returning malformed tool call output?
Prompt 4
Show me how to set up Nyx's approval workflow so I can review diffs before they apply.

Frequently asked questions

What is nyx-local-ai?

A local-first AI coding agent extension for VS Code and Cursor that runs on your own hardware through Ollama, LM Studio, or similar tools, with zero per-token cost.

What language is nyx-local-ai written in?

Mainly TypeScript. The stack also includes TypeScript, VS Code, Ollama.

What license does nyx-local-ai use?

The provided excerpt does not state the license terms.

How hard is nyx-local-ai to set up?

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

Who is nyx-local-ai for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.