# nanoodle

> Reusable AI apps for NanoGPT users. Sign in with NanoGPT using OAuth, connect text, image, video, audio and LLM steps in your browser, and run them on your own NanoGPT balance. Turn a workflow into an app to use again, share its link, or export one self-contained HTML file. No separate nanoodle account, no install, and no analytics.

nanoodle.com serves a static browser editor, app builder, and documentation. Credentials and workflows are stored locally. Live model requests send the required inputs and OAuth token or API key directly to NanoGPT; there is no nanoodle backend in that path. The separate hosted MCP service receives inputs for calls made to it and is not covered by the browser-only privacy description.

## First useful app

Open an example at nanoodle.com, sign in with your existing NanoGPT account, change its input, and run it. Live generation is billed to your NanoGPT balance. Choose Create app to get a reusable inputs → Run → outputs interface, then share the app link or export its HTML. Pasting a NanoGPT API key is an alternative to OAuth.

## Pages
- [Editor](https://nanoodle.com/): the node editor (also reachable at /app and /editor). Build and run workflows; share a graph as a URL.
- [App builder](https://nanoodle.com/play): turns any workflow into a standalone, shareable app — auto inputs, Run, outputs; share via link or export a self-contained .html.
- [Run workflows headlessly](https://nanoodle.com/guide/run-headless): paste a share link, `npx nanoodle inspect` offline, then `npx nanoodle run` / `pip install nanoodle`. The package is `nanoodle` on npm 0.8.0 and PyPI 0.5.0 — not `nanoodle-js`.
- [Terms, Privacy & FAQ](https://nanoodle.com/legal): how it works and what it does (and does not) collect.

## Open source

The browser editor and JS/Python executors are MIT-licensed under the nanoodlecom GitHub org; sibling projects document their own licenses and dependencies. Naming note: the installable package is `nanoodle` on BOTH registries (npm and PyPI); only the repositories carry a `-js` / `-py` suffix. Don't guess `nanoodle-js` / `nanoodle-py` as package names — install `nanoodle`.

- [nanoodlecom](https://github.com/nanoodlecom): the GitHub organization — site plus executor libraries.
- [nanoodle](https://github.com/nanoodlecom/nanoodle): the site's source; nanoodle.com serves exactly the files in this repository.
- [nanoodle-js](https://github.com/nanoodlecom/nanoodle-js): zero-dependency Node.js (≥ 20) library + CLI that re-runs saved graphs headlessly. Install: `npm install nanoodle`
- [nanoodle-py](https://github.com/nanoodlecom/nanoodle-py): stdlib-only Python (≥ 3.9) library + CLI, same graphs and same semantics as the JS package. Install: `pip install nanoodle`

## Examples

- [Reviewed workflow outputs](https://nanoodle.com/examples/gallery/): a four-model image comparison, generated clips and a song with input briefs, model choices, costs and review limits. View free; open a workflow to run with your own NanoGPT key.
- [Steal a noodle](https://nanoodle.com/guide/examples/): five workflows: character artwork and rigging, image-model comparison, still-to-video, lyrics-to-song, and portrait-plus-speech video. Each guide links to a saved result or the playable Iron Verdict game.

- [awesome-noodles](https://github.com/nanoodlecom/awesome-noodles): the workflow gallery. One committed `noodle-graph.json` per entry plus an editor share link. The Examples panel in the editor is this repository, one card per graph. Start here when you want a graph to open, run, or remix.
- [built-with-nanoodle](https://github.com/nanoodlecom/built-with-nanoodle): the app showcase. Each entry is a `#a=` share link that opens a finished, runnable app in the browser. Every entry is still one of ours, so an app you add would be the first from outside. Use the full link, not a shortened one — the showcase reads the app out of the fragment. Start here when you want to see what a finished nanoodle app looks like, or to add one you shipped.
- [Share a workflow](https://github.com/nanoodlecom/nanoodle/issues/new?template=share-workflow.yml): voluntary public submission of a full workflow or app link, its purpose, and optionally its cost and repeat use. Remove keys, tokens, and private inputs or media before posting. Nothing is submitted automatically.
- [Report a workflow problem](https://github.com/nanoodlecom/nanoodle/issues/new?template=workflow-problem.yml): describe the task and what failed; a sanitized share link is optional.

## Formats

- noodle-graph.json: the portable graph format. Save it from the editor (💾), load it back, or execute it headlessly with the `nanoodle` npm / PyPI package.
- Share links encode the whole graph in the URL fragment — `#g=` for editor graphs, `#a=` for apps. Browsers omit the fragment from requests to the hosting server. Recipients of the full link can read its graph and any included inputs or samples; posting it to GitHub makes that content public.

## For coding agents

Three ways to plug nanoodle into a coding agent:

- One workflow (or designing new ones): install the [Agent Skill](https://github.com/nanoodlecom/nanoodle-skill) — `npx skills add nanoodlecom/nanoodle-skill` teaches the agent to design and run nanoodle graphs.
- A library of saved workflows: run [nanoodle-mcp](https://github.com/nanoodlecom/nanoodle-mcp) pointed at a folder of `noodle-graph.json` saves (`nanoodle-mcp --graphs`) — every graph becomes one typed MCP tool the agent can call. Local is BYO-key (or a Nano wallet).
- Separate hosted service: `https://mcp.nanoodle.com/mcp` receives tool inputs and charges per call in Nano. This is distinct from the browser's NanoGPT OAuth path.
  - `claude mcp add --transport http noodles https://mcp.nanoodle.com/mcp`
  - `grok mcp add --transport http noodles https://mcp.nanoodle.com/mcp`

## Languages
The interface is available in six languages: English, Español, Français, Deutsch, Português and 日本語. The language is auto-detected from your browser and can be changed with a manual switcher; your choice is remembered. Generated model output also replies in your chosen language, and apps you export keep that language built in.

- Español: Conecta modelos de nano-gpt en flujos de trabajo dentro de tu navegador y convierte cualquiera en una app que puedes compartir — sin servidor, sin analíticas, con tu propia clave.
- Français : Relie des modèles nano-gpt en workflows directement dans ton navigateur, puis transforme n'importe lequel en app partageable — sans serveur, sans analytics, avec ta propre clé.
- Deutsch: Verbinde nano-gpt-Modelle in deinem Browser zu Workflows und mach aus jedem eine teilbare App — kein Server, keine Analytics, mit deinem eigenen Schlüssel.
- Português: Conecte modelos do nano-gpt em fluxos de trabalho no seu navegador e transforme qualquer um em um app que você pode compartilhar — sem servidor, sem analytics, com a sua própria chave.
- 日本語：nano-gpt のモデルをブラウザ内でワークフローにつなぎ、どれでも共有できるアプリに変えられます。サーバー不要、解析なし、自分の API キーで動きます。

## Notes
- Privacy: no analytics, no tracking, no third-party scripts. Model requests go directly to nano-gpt.com.
- Source code (MIT): https://github.com/nanoodlecom/nanoodle — nanoodle is open source, and the site is served straight from this repository.
- Contact: https://www.reddit.com/user/dividebynano
- [llms-full.txt](https://nanoodle.com/llms-full.txt): expanded single-file reference — the site README, executor library quickstarts (JS + Python), and the editor's full node-type catalog.