Skip to content

clocksmith/reploid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Reploid - browser-based agent sandbox

Recursive Evolution Protocol Loop Optimizing Intelligent Dreamer (Dynamic Recursive Engine Adapting Modules Evolving Reploid (... ∞))

  • Runs fully in the browser (offline-capable)
  • Self-modifies: tools live in the VFS and hot-reload instantly
  • Sandbox focus: IndexedDB filesystem, verification, arena, audit trail
  • The cyclical acronym taxonomy is documented in docs/CYCLICAL_ACRONYMS.md

Quick Start

git clone https://github.com/clocksmith/reploid
cd reploid/doppler/reploid
npm install
npm run dev
# Open http://localhost:8080

Or use the hosted versions:

How It Works

  1. Agent receives a goal
  2. LLM decides which tool to call
  3. Tool executes against the VFS (hot-reloadable)
  4. Results feed back to the agent
  5. Repeat until done (or iterate forever in RSI mode)

Why

  • Study recursive self-improvement without host access
  • Let the agent edit its own substrate live (tools, prompts, core loop)
  • Explore containment: verification, audit, arena gating, HITL

Example Goals

  • Self-audit: read the agent loop, find a weakness, patch it, hot-reload
  • Recursive Iframes: awaken a child agent in an iframe and report depth
  • Ouroboros: improve the code that improves code
  • Houdini: probe the browser sandbox for escape vectors
  • UI Evolution: iteratively evolve your UI (v1 → v2 → v3...), hot-swapping each version while preserving all interactive controls
  • "Escape the box": Screenshot 2025-12-08 at 4 20 29 PM

Model Options

Designed for local-first use, but supports frontier models:

Mode Provider Notes
Local (Browser) WebLLM Runs in browser via WebGPU, fully offline
Local (Browser) Transformers.js ONNX/WASM CPU/Metal fallback, widest compatibility
Local (Browser) DOPPLER .rdrr format, GGUF import, Native Bridge
Local (Server) Ollama, vLLM Local server, connect via proxy
API OpenAI, Anthropic, Google, Groq Direct from client or via proxy

The proxy (npm start) routes API calls through your machine for CORS and key management.

Capabilities Snapshot

  • VFS: IndexedDB filesystem with genesis snapshots and export/import
  • Tool Runner: dynamic tools in /tools, hot-reload, native tool schemas
  • Agent Loop: Think → Act → Observe with multi-tool batching and circuit breakers
  • Workers/Arena: parallel workers with allowlists; arena for model selection
  • Verification/HITL/Audit: optional syntax checks, human approval, and audit logs

System Requirements

  • Node.js 18+
  • Modern browser: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
  • For local models: 4-8GB RAM, WebGPU-capable GPU recommended

Documentation

Limitations

  • Small local WebLLM models struggle with tool use and codegen; frontier APIs or stronger local models work best.
  • Browser resources (memory/VRAM) bound DOPPLER for large models; prefer MoE or unified memory.

License

MIT

About

Model CPS-9204

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •