Spaces:
Running
Running
File size: 5,935 Bytes
f16878d b30b7c5 f16878d b30b7c5 f16878d b30b7c5 4bd8362 f16878d 4bd8362 b30b7c5 4bd8362 b30b7c5 4bd8362 b30b7c5 4bd8362 b30b7c5 4bd8362 d305959 4bd8362 b30b7c5 6b45f01 b30b7c5 4bd8362 6b45f01 4bd8362 b30b7c5 4bd8362 022d4ca d305959 022d4ca d305959 022d4ca d305959 022d4ca d305959 022d4ca d305959 022d4ca d305959 022d4ca 4bd8362 022d4ca d305959 4bd8362 022d4ca d305959 022d4ca d305959 31d404a 4bd8362 31d404a | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 | ---
title: Elffuss Code
emoji: 🧑💻
colorFrom: purple
colorTo: pink
sdk: static
app_file: index.html
pinned: false
license: apache-2.0
short_description: A VS Code-style IDE with a local AI agent, in-browser
tags:
- webgpu
- local-llm
- agent
- code
- lfm
- transformers.js
---
# 🧑💻 Elffuss Code: put your computer to code with you
Open a folder from your disk and a full web IDE unfolds around it: Monaco (the VS Code editor),
a file tree, tabs, and an AI agent that **reads, searches and edits your project for real**.
The model runs on **your** GPU through WebGPU. Your code never leaves your machine. Free, no
account, no API key.
> ⚠️ **Open it full-screen** ([direct link](https://utopiaia-elffuss-code.static.hf.space)). The
> File System Access API (opening a local folder) is blocked inside the embedded iframe.

In the demo a **small model running entirely in the browser** reads `calc.py`, finds a real
bug and fixes it with a minimal edit: genuine tool calls, not autocomplete.
## What's new
- **Our own engine.** The default brain is **LFM3 1.7B** running on Elffuss Engine, a WebGPU
runtime we wrote ([source](https://github.com/utopia-ia/elffuss-engine)). It is also the
default on phones, in a smaller build. Gemma-4 (LiteRT-LM) and Qwen3.5 (ONNX) are still in
the model picker.
- **Install it as an app.** Code offers to install itself (PWA), so it opens in its own window.
- **VS Code extensions.** Search [Open VSX](https://open-vsx.org) from the Extensions panel and
install color themes, grammars, snippets and language settings, checked against the SHA-256
Open VSX publishes. Extensions that *run code* need a sandbox on a separate site, so they
work on [code.elffuss.com](https://code.elffuss.com) and not in this Space.
- **A new look**, a project city view, search fixed in the header, and a console that is never
covered.
- **Says what's wrong.** If WebGPU exists but the GPU is blocked right now, Settings says so
instead of claiming your browser has no WebGPU.
## Why it's different
- **Your code stays local.** The folder is opened through the File System Access API: no upload, no account.
- **Real tool calling**: `code.tree`, `code.read`, `code.search`, `code.edit`, `code.write`. You watch every call.
- **Edits, not rewrites**: the agent patches the lines that change, even in files of several megabytes.
- **Long tool results don't break the conversation**: they are compacted to fit the model's context.
- **Context retrieval that works beyond English**, accents and Cyrillic included (measurements below).
- **Real editor**: Monaco, file tree, tabs, `Ctrl+S`, and the git branch and last commit read straight from `.git`.
- **Zero install, zero build.** Vanilla ES modules.
- **Your language**: the whole IDE follows your browser's language (English, Spanish and more).
- External providers (OpenAI, Anthropic, Ollama) are **opt-in**; keys stay in your browser.
- Optional local **bridge** for real `node` / `npm` / `python` runs, downloaded from the main site with its SHA-256.
Chrome or Edge recommended (WebGPU and File System Access).
## How it's built
Write-ups on the whole stack (model, runtime, agent harness, editor and file access, all in one
tab): **<https://bitacora.utopiaia.com/#elffuss>**
## Context management: how it's measured
The context packer isn't chosen by intuition. Numbers measured at the **same token budget**:
**Real agent sessions** (25 sessions, 174 probes, fact recall, no LLM judge):
| | recall |
|---|---|
| tail truncation | 7.0 % |
| previous version | 15.1 % |
| **current** | **65.3 % ± 8.5** |
**Long-term memory** (200 questions, F1 from the benchmark's own repo, a real model answering, ~8 % of the context):
| | F1 |
|---|---|
| **the FULL context, uncompressed** | **22.56** |
| tail truncation | 6.62 |
| hand-written heuristics | 6.07 |
| BM25 without IDF | 20.34 |
| BM25 | 23.59 |
| embeddings | 23.95 |
| **rank fusion (BM25 + embeddings)** | **28.09** |
**Retrieving well beats having everything**: 28.09 vs 22.56 with 8 % of the tokens. Irrelevant
context isn't neutral ballast; it distracts.
Two more things that were measured, not assumed: turning the heuristics on cost **−3.02 F1**, and
removing IDF costs **−3.25**. Semantic search doesn't replace lexical search, it covers its blind
spot: with no vocabulary overlap between question and answer, embeddings win (24.28 vs 18.60);
with overlap, BM25 wins (29.33 vs 23.58), and fusion keeps both.
References: BM25 (Robertson et al., TREC-3 1994) · IDF (Spärck Jones, 1972) · RRF (Cormack et al., SIGIR 2009) ·
MMR (Carbonell & Goldstein, SIGIR 1998) · attention sinks (Xiao et al., ICLR 2024) · valid time (Snodgrass & Ahn, SIGMOD 1985).
The full story, including what went wrong: <https://bitacora.utopiaia.com/posts/16-beaten-by-doing-nothing.html>
## The Elffuss family
- 🌐 Full app: <https://code.elffuss.com>
- 💻 Source (Apache-2.0): <https://github.com/utopia-ia/elffuss-code>
- ✳️ Elffuss Claw, ask for an app and your computer builds it: <https://claw.elffuss.com> · [Space](https://huggingface.co/spaces/UtopiaIA/elffuss-claw)
- 🗣️ Elffuss Translator, speech-to-speech translation on your device: <https://translator.elffuss.com> · [Space](https://huggingface.co/spaces/UtopiaIA/elffuss-translator)
- 📝 Elffuss Copilot, live call notes that never leave your browser: <https://copilot.elffuss.com>
- 🪢 Elffuss Braid, version control for many coding agents: <https://braid.elffuss.com> · [Space](https://huggingface.co/spaces/UtopiaIA/elffuss-braid)
- ⚙️ Elffuss Engine, the WebGPU runtime: <https://github.com/utopia-ia/elffuss-engine> · [notes](https://huggingface.co/spaces/UtopiaIA/elffuss-motor)
- 🧬 Shared core: <https://github.com/utopia-ia/elffuss>
- 📰 All apps and the blog: <https://elffuss.com>
|