Skip to content
zowskyyPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

24 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ Lighthouse

Free offline AI coding agent. No subscription. Works on phones, RPi, anything.

Quick Start

npm install          # One dependency: express
node setup.js        # Download model (~4GB, one-time)
node core.js         # Start server
# Open http://localhost:8899

Mobile — Three Tiers

Tier What Setup
1: PWA Browser + home screen install Open http://<server>:8899 on phone
2: Capacitor Native Android/iOS app shell cd mobile/capacitor && npm install && node build-mobile.js
3: WebLLM On-device AI in browser (WebGPU) Tap 🧠 On-Device in app header

Connect your phone (Tier 1)

  1. Run node core.js on your laptop/RPi
  2. Open http://<server-ip>:8899/connect.html on any device
  3. Scan the QR code with your phone

Native app (Tier 2)

cd mobile/capacitor
npm install
node build-mobile.js --server http://192.168.1.10:8899
npm run add:android    # first time
npm run android        # open Android Studio

See mobile/capacitor/README.md.

On-device AI (Tier 3)

Requires Chrome 127+ with WebGPU and 8GB+ RAM. Enable via the header toggle. See mobile/webllm/README.md.

Modes

Mode What it does
Server mode Uses llama-server (fastest, persistent)
CLI mode Uses llama-cli (works everywhere)
Learning mode No model needed — explains concepts
On-device (WebLLM) Model runs in browser via WebGPU

Features

  • 🧠 ARC Cycle — Analyzes → Plans → Codes → Self-Reviews
  • 💡 Idea Mode — Describe your idea, get questions, then code
  • 📱 Phone Ready — PWA, voice input, share sheet, wake lock
  • 🔌 Fully Offline — After model download, zero internet
  • 💾 Projects — Save and load your work
  • 🖥️ CLI — Terminal mode for headless systems

Field deployment

node deploy.js test                    # Verify readiness
node deploy.js ship east-africa        # Full kit + docs + training + partners
node deploy.js kit south-asia          # Community Kit only
./deploy.sh all global                 # Shell wrapper

Regions: east-africa, south-asia, southeast-asia, latin-america, west-africa, global

Output goes to deploy/ — Community Kits, offline docs, i18n, Navigator training, partner packages, impact dashboard.

Release builds

CI/CD (ships all 13 formats): push a version tag and GitHub Actions builds everything:

git tag v1.0.2 && git push origin v1.0.2

Manual:

node release.js --dry-run
node release.js all

See RELEASE_CHECKLIST.md.

Requirements

  • Node.js 18+
  • 4GB free disk space (server model)
  • 2GB+ RAM (4GB recommended; 8GB+ for on-device WebLLM)

Cursor Gate

This repo includes the Cursor Gate stack for agent-driven code review. Gate reviewer deps live in requirements-gate.txt (Node runtime deps remain in package.json).

pip install -r requirements-gate.txt
bash scripts/install-agent-environment.sh
bash scripts/gate-file.sh --file samples/hello_passing.py

PR CI: workflow Gate Check runs the gate on samples/hello_passing.py. Gap audit: docs/ROADMAP.md.

Gate scope note: core.js and deploy.js are not individually gated yet — they are large runtime modules. CI gates samples/hello_passing.py as the agent-policy smoke test. Critical JS changes should be reviewed manually or via future sample wrappers (see ROADMAP milestone 2).

Frontier / Project Nexus

Frontier integration (PR #3) was reverted on main; the path forward is the mirrored project-nexus/ tree, which tracks zowskyy/project-nexus until the Cursor GitHub App has push access.

cd project-nexus
python3 build/arc_orchestrator.py --slides 15

See project-nexus/MIRROR.md and project-nexus/README.md for architecture. Lighthouse runtime (core.js) remains Node/Express; Frontier re-integration is planned once the standalone project-nexus repo is gate-ready.

License

MIT — Free forever.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages