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.

![demo](https://utopiaia.com/demos/elffuss/elffuss-code-demo.gif)

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>