Skip to content

neurabytelabs/modus-forge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

27 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”₯ MODUS Forge

Speak it. See it. Use it.

"The App Store is dead. The future is ephemeral, personal software forged by AI in seconds." β€” Inspired by Andrej Karpathy's vision

MODUS Forge turns a single sentence into a fully functional, personal dashboard β€” no app store, no downloads, no subscriptions. Just your intent, your data, your app.

modus-forge "Track my cardio for 8 weeks"

β†’ Generates a complete, self-contained HTML dashboard
β†’ Connects to your sensor APIs (Apple Health, Garmin, Woodway...)
β†’ Opens in your browser, ready to use
β†’ Yours. Not a template. Not a generic app. Yours.

How It Works

You β†’ "Track my cardio for 8 weeks"
         ↓
    RUNE Engine (prompt enrichment + 8-layer framework)
         ↓
    Context Layer (your data, preferences, connected APIs)
         ↓
    LLM Generation (Gemini / Claude / GPT)
         ↓
    Spinoza Validator (quality control: Conatus, Ratio, Laetitia, Natura)
         ↓
    index.html β†’ open in browser πŸš€

Philosophy

Every app is a modus β€” a mode of existence, unique to the person who needs it.

We don't believe in one-size-fits-all software. We believe in software that exists only because you need it, shaped by your context, and disposable when you don't.

"God is Nature" β€” Spinoza
Your intent is the app. The app is the intent.

Features

  • 🧠 RUNE-Powered β€” Prompts are enhanced through an 8-layer framework before hitting the LLM
  • πŸ”Œ Sensor Discovery β€” Auto-detects and integrates available APIs (health, fitness, finance, weather, IoT...)
  • 🎨 Beautiful by Default β€” Dark cyberpunk aesthetic, data-dense, interactive dashboards
  • βœ… Spinoza Validated β€” Every output is checked for actionability, logic, beauty, and naturalness
  • πŸ“¦ Zero Dependencies β€” Single HTML file, works offline, double-click to open
  • πŸ”’ Private β€” Runs locally. Your data stays yours.

Quick Start

# Install
npm install -g modus-forge

# Forge your first app
modus-forge "Track my daily water intake"
modus-forge "Monitor my portfolio: AAPL, TSLA, BTC"
modus-forge "Plan my 8-week marathon training"
modus-forge "Dashboard for my home energy usage"

# With options
modus-forge "Track my sleep" --model gemini-3-pro --style minimal
modus-forge "Budget tracker" --connect "bank-api" --lang tr

Architecture

modus-forge/
β”œβ”€β”€ bin/                  # CLI entry point
β”‚   └── forge.js
β”œβ”€β”€ lib/
β”‚   β”œβ”€β”€ rune/             # RUNE prompt engine
β”‚   β”‚   β”œβ”€β”€ enhancer.js   # 8-layer prompt enrichment
β”‚   β”‚   └── validator.js  # Spinoza quality control
β”‚   β”œβ”€β”€ context/          # Personal context layer
β”‚   β”‚   β”œβ”€β”€ sensors.js    # API/sensor discovery
β”‚   β”‚   └── profile.js    # User preferences & history
β”‚   β”œβ”€β”€ generators/       # LLM code generation
β”‚   β”‚   β”œβ”€β”€ gemini.js
β”‚   β”‚   β”œβ”€β”€ claude.js
β”‚   β”‚   └── openai.js
β”‚   └── renderer/         # Output formatting
β”‚       β”œβ”€β”€ html.js       # Single-file HTML builder
β”‚       └── preview.js    # Browser preview launcher
β”œβ”€β”€ templates/            # Base design system templates
β”‚   β”œβ”€β”€ dashboard.html
β”‚   β”œβ”€β”€ tracker.html
β”‚   └── monitor.html
β”œβ”€β”€ skills/               # Sensor integration skills
β”‚   β”œβ”€β”€ health/           # Apple Health, Garmin, Fitbit...
β”‚   β”œβ”€β”€ finance/          # Portfolio, banking APIs...
β”‚   β”œβ”€β”€ iot/              # Smart home, energy...
β”‚   └── custom/           # User-added integrations
β”œβ”€β”€ package.json
└── README.md

The Vision

Andrej Karpathy said it best: a cardio experiment tracker is ~300 lines of code. There will never be (and shouldn't be) a specific app store entry for it.

MODUS Forge is the missing layer:

Yesterday Today Tomorrow (Forge)
Search app store Vibe code for 1 hour "Track my cardio" β†’ done in 60 seconds
Download generic app Fix bugs manually RUNE validates automatically
Adapt to the app Reverse-engineer APIs Sensors discovered & connected
Data in their cloud Data in your HTML Data stays local

The industry needs to reconfigure into AI-native sensors & actuators. Until then, Forge bridges the gap β€” reverse-engineering APIs so you don't have to.

Built With

  • RUNE β€” Prompt engineering framework ("Every prompt is a spell")
  • MODUS β€” Universe simulation platform (Spinoza philosophy)
  • OpenClaw β€” AI agent orchestration

Roadmap

  • Concept & architecture
  • CLI MVP (single prompt β†’ HTML)
  • RUNE integration (prompt enrichment)
  • Sensor discovery (Apple Health, Garmin)
  • Template library (dashboard, tracker, monitor)
  • Spinoza validation loop
  • Multi-LLM support (Gemini, Claude, GPT)
  • Persistent apps (auto-update, live data)
  • Community skills marketplace

NeuraByte Labs

"Where Spinoza Meets Silicon"

MODUS Forge is a NeuraByte Labs project.

License

MIT

About

πŸ”₯ Speak it. See it. Use it. β€” Turn a sentence into a personal app in seconds. Ephemeral software forged by AI.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages