No description
  • TypeScript 87.3%
  • CSS 5.4%
  • Rust 3.1%
  • HTML 2.3%
  • JavaScript 1.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-16 21:39:54 -08:00
.github/workflows Release workflow for Windows, Linux and macOS installers; track app icons; version from Cargo.toml 2026-10-27 19:48:54 -07:00
mds sillytavern quick start, built in chat import, initial card import 2026-10-28 17:16:48 -07:00
public readme update + widget screenshots 2026-10-27 15:22:34 -07:00
scripts add fake test provider 2026-11-08 17:15:23 -08:00
skills/widget-authoring widgets: instance ids, saved state and widget messages 2026-11-16 15:51:16 -08:00
src better run_js, add max-out to samplers 2026-11-16 21:39:54 -08:00
src-tauri widgets: instance ids, saved state and widget messages 2026-11-16 15:51:16 -08:00
tests better run_js, add max-out to samplers 2026-11-16 21:39:54 -08:00
.editorconfig tabs everywhere 2026-08-31 17:01:38 -07:00
.gitignore Add fold tool: collapse a finished span of the chat into a note 2026-11-05 00:14:16 -08:00
agents.md better run_js, add max-out to samplers 2026-11-16 21:39:54 -08:00
bun.lock streaming markdown rendering (kinda) 2026-10-27 19:26:18 -07:00
bunfig.toml persist tab and better update time tracking 2026-05-18 17:57:48 -07:00
converter.js updated conversion scripts 2026-06-12 20:49:56 -07:00
index.html renaming, readme and license 2026-06-08 13:50:03 -07:00
jsconfig.json initial 2025-04-25 17:26:47 -07:00
LICENSE renaming, readme and license 2026-06-08 13:50:03 -07:00
package.json streaming markdown rendering (kinda) 2026-10-27 19:26:18 -07:00
README.md sillytavern quick start, built in chat import, initial card import 2026-10-28 17:16:48 -07:00
tsconfig.json sqlite storage for tauri + tests 2026-05-14 21:27:24 -07:00
vite.config.js remove profiling and minor optimizations (static db import) 2026-05-30 17:08:38 -07:00

Nugram

A Desktop and web app for LLM chat and Agentic Loops.

This product is under active development.

This project was built off of two frustrations with existing apps:

  1. lack of control over what the LLM sees
  2. lack of a nice gui for coding agents

Plus a bonus, while developing 3. bloated and inefficient context

Lack of control over what the LLM sees: Here's a little secret about LLM "chats". They're an illusion. Your "chat" is simply a nicely formatted document the LLM is asked to continue writing. Now, this "document" is fully controllable by the app. So why do most give you so little control, beyond sending a new message and regenerating the last one?

Nugram lets you regenerate, continue and edit any message in the chat, including the Assistant (AI)'s and tool calls. You can change history, gaslight the LLM or be the LLM.

Lack of a nice gui for coding agents: This has improved, but when the project started, Claude code, Codex, Pi, Opencode etc. were all just TUIs. I don't mind using the terminal, but TUI's feel like a regression of GUI tech by two decades. There's no accessibility, no proper text editing, no buttons or mouse usage.

Bloated and inefficient context: Many existing tools will waste tens of thousands of tokens on the system prompt and a dozen tools, and expect agents to burn a turn for every edit even when they know them all in advance.

Features

  • Providers: any OpenAI-compatible API (Chat Completions or Responses), plus dedicated support for OpenRouter, Z.ai, NanoGPT, Fireworks, Neuralwatt
  • Message Versioning: track and navigate between multiple versions of messages
  • Message Editing: edit the thinking, content and tool results of any message in the chat
  • Chat Forking: fork a conversation at any message (an independent copy that remembers where it came from) or duplicate it whole
  • Context Control: per-chat cut points that hide earlier messages from the model, and auto-compaction that summarizes and moves the cut during agent loops
  • Request Control: per-model sampler overrides, and extra JSON body args matched by provider and model
  • Tools: native tool calling with permission prompts. Web search and fetch everywhere; shell, file reading and multi-edit file editing (desktop). MCP support on roadmap
  • run_js: based on Cloudflare's Code Mode. The model writes JavaScript that calls the other tools as functions, so a batch of reads, edits or searches takes one turn instead of many. Globals persist per chat. An optional run_js-only mode has models do everything via writing scripts, which can be unexpectedly powerful
  • Sub-agents (desktop): the model can spawn agents with their own tools, with configurable model tiers and per-config presets with their own tools, prompts, reasoning levels etc.
  • Remote Backends (desktop): run shell and file tools on another machine over SSH
  • Widgets (desktop): small local HTML apps the model can show inline in chat, sandboxed and following the app theme
  • Lore System: a "Lorebook" for building a small searchable wiki with names, descriptions and content, which the model can read and edit through tools
  • Themes: built-in themes (fantasy, scifi, modern) with light/dark variants. Custom themes and more control on roadmap
  • Inline HTML: the web nature of the app means your LLMs can use HTML freely for advanced or stylized formatting (great for immersive stories)

A recipe widget with servings scaling and checkable steps A project timeline widget with tasks grouped by owner

Getting Started

Coming from SillyTavern? See the quickstart for SillyTavern users.

Requirements: bun, plus cargo for the desktop app.

git clone https://github.com/Tamnac/nugram.git
cd nugram
bun install

bun dev          # web dev server at localhost:3000
bun tauri dev    # desktop app with hot reload
bun test         # test suite

bun build        # static web build to dist/
bun tauri build  # desktop installer

Pushing a tag like v0.2.0 makes GitHub Actions build the installers (.github/workflows/release.yml) and attach them to a draft release: .msi for Windows, .deb and .AppImage for Linux, .dmg for Apple Silicon Macs. Keep the tag in step with the version in src-tauri/tauri.conf.json and Cargo.toml.

Platform support: the app is developed and tested on Windows only. The Linux and macOS builds are untested and may have bugs or missing features. The macOS app is unsigned, so Gatekeeper will say it is damaged: run xattr -cr /Applications/Nugram.app once after installing, or right-click the app and choose Open.

Set provider keys and/or URLs in the sidebar. The app itself provides no LLM inference.