🚀 Kitwork — The Industrial-Grade Logic Operating System

An ultra-lightweight, sovereign logic execution engine powered by Go. Run APIs, cron schedules, templates, and background tasks on a custom stack-based bytecode virtual machine with nanosecond precision.

const { router, log, database, go } = kitwork();

// Fluid Routing & High-Frequency Logic
router.get("/api/v1/orders/:id")
    .cache("30s")
    .handle((req, res) => {
        const order = database.orders.find(req.params("id"));
        if (!order) return res.status(404).json({ error: "Order not found" });
        return res.json({ success: true, data: order });
    });

⚡ Performance Dashboard

Kitwork is engineered for Nanosecond-Precision Sovereign Execution. We optimize down to the bytecode level to bypass traditional runtime overhead.

💎 Key Features

• Custom Stack-Based VM: A dedicated bytecode engine optimized for zero-GC pressure and constant-time variable access.
• Unified JS Context: Destructure routes, databases, network fetchers, and logging from a single kitwork() constructor.
• Zero-Copy Routing: A lightning-fast, trie-based router capable of handling path parameter parsing, query matching, and static directory mappings with OS-native speed.
• The Energy Economy: Built-in physical limiters mapping memory and CPU usage to "Energy Cost" to prevent logic leaks and spam.
• Natural Language Scheduling: Avoid complex cron notation. Chain temporal triggers directly in code:

  kitwork().schedule()
      .daily("01:00")
      .every("10s")
      .handle(() => database.logs.where(l => l.age > "30d").destroy());
  

• Zero Dependencies: Packaged into a single, compact executable. No Node.js, no Docker, no external runtimes required.

🏁 Quick Start

Get your sovereign engine running locally in under 60 seconds:

1. Install & Build

Ensure you have Go installed on your system:

git clone https://github.com/kitwork/kitwork.git
cd kitwork
go run .

2. File Structure

Define your routes and system logic under the tenants/ directory:

kitwork/
├── config.kitwork.yaml      # Global configuration file (port, sources)
├── main.go                  # Engine entry bootstrap
└── tenants/
    └── test/
        └── localhost/
            └── app.kitwork.js  # VM router and script logic

3. Global Config (config.kitwork.yaml)

port: 8080
source: "tenants"

4. Write Your First Route (app.kitwork.js)

const { router } = kitwork();

router.get("/hello").handle((req, res) => {
    return res.html("<h1>Hello from Kitwork VM!</h1>");
});

✒️ Author's Note

"While the world is busy using AI to automate everything, I choose to breathe a soul into every line of code. I write code like essays, like unspoken confessions. I use AI not to replace myself, but as a mirror to reflect my own inner world. I expose this system to the world simply because it is beautiful, crazy, and dreamy."

— Huỳnh Nhân Quốc, Indie-Stack Developer ❤️

Released under Apache 2.0 License.
Support development: Sponsor Kitwork