Skip to content

Repository files navigation

The browser IS the IDE. The cloud IS the machine.

An industrial-grade Cloud IDE & Agentic AI coding platform: 5 core microservices, 3 in-pod sidecars, 8 Docker images, running on real Kubernetes sandboxes, with an autonomous AI agent that ships code for you.

License: MIT Kubernetes Docker Images Core Services RabbitMQ Redis LangChain

Built solo, top to bottom, by Harsh Patel


See it in action


Platform overview

Monaco editor + live workspace explorer

Live dev server preview + HMR

Autonomous AI pair programmer

🎥 AWS EKS Live Production & Auto-scaling Proof

Note

AWS Hosting Status: INKz was fully deployed and benchmarked on AWS EKS with Auto-scaling (Cluster Autoscaler & Horizontal Pod Autoscaler). Due to high recurring AWS cloud infrastructure costs (EKS control plane, node groups, load balancers), the active cloud deployment is currently turned off. You can watch the full live deployment & auto-scaling proof video below, or self-host it locally for free using Docker Desktop / K3s!


Story behind INKz

I used to use AI development tools like Lovable, Bolt.new, and Replit and wondered how they actually worked under the hood. How do they spin up instant cloud environments, stream real terminal sessions, and let an AI agent modify full codebases autonomously? That curiosity drove me to build INKz from scratch to solve that exact engineering challenge.

Instead of a simple wrapper around an API call, INKz is a complete event-driven system: five core microservices communicating over REST and RabbitMQ AMQP, a Redis-backed lifecycle engine managing sandbox pods, and three sidecar containers keeping filesystem, terminal, and AI tooling in sync.


What makes it click

Feature Powered by What it actually does
~4s sandbox boot Kubernetes + Docker Isolated dev environments spin up in seconds, zero local config required
Real-time S3 sync chokidar + AWS SDK Continuous, bi-directional workspace mirroring: nothing is ever lost when a pod dies
AI coding assistant LangChain ReAct agent Full codebase context, autonomous multi-file edits, real terminal execution
Browser IDE runtime Monaco + live HMR True VS Code feel, with an integrated dev server preview and instant port forwarding
Enterprise infrastructure Kubernetes + Redis TTL-managed sandbox pods, heartbeat persistence, multi-tenant isolation baked into RBAC

Every one of these is a real working mechanism, not a marketing bullet: the ~4s boot is the actual pod scheduling time on a warmed node, the S3 sync is a live chokidar watcher with a 500ms write-stability threshold, and the AI agent genuinely reads, writes, and executes inside your live sandbox rather than guessing from a snippet you pasted in.


What is INKz

No installs. No node_modules eating your disk. No "works on my machine." Open a URL and get a full VS Code-grade IDE, wired live to an isolated Kubernetes container that boots in seconds, with an AI coding partner sitting right next to you that can read your whole codebase and ship multi-file changes on command.

Develop on your laptop with Docker Desktop, then ship the exact same manifests to AWS EKS with one Skaffold profile switch. The architecture doesn't change between your machine and production: the same Kubernetes manifests, the same microservices, the same AI agent, just pointed at a bigger cluster.


Architecture at a glance

INKz runs on 5 core microservices, each its own Dockerfile, each independently deployable and independently scalable:

Service What it does
auth Google OAuth 2.0, JWT cookie issuance, early-access intake
sandbox Talks to the Kubernetes API directly: the control plane that spins up, tracks, and tears down every developer's pod
ai-orchestration Runs the LangChain agent: reads, writes, and refactors your code autonomously
notification Consumes RabbitMQ events, fires transactional emails via Brevo
router Subdomain-aware reverse proxy that beams your live dev server and terminal straight into the browser

Inside every user's pod, 3 lightweight sidecars do the real-time work: template seeds the base workspace on first boot, agent exposes a file API the AI can act on, and sync-agent mirrors the filesystem to S3 as you type. They aren't top-level services: they're the muscle that makes each sandbox self-sufficient, and they live and die with the pod they belong to.

Kill any core service and the rest keep running. Auth goes down and sandboxes still boot; notification goes down and logins still succeed. That isolation isn't a README claim: it's the actual namespace and RBAC model underneath, backed by a Redis TTL lifecycle that reclaims idle pods automatically and a RabbitMQ event bus that keeps every service loosely coupled.


AI that isn't locked to one vendor

The agent runs on Mistral by default, but the LangChain integration is fully pluggable: swap in Gemini 1.5 Pro, OpenAI, DeepSeek, Claude, or a 100% offline Ollama model with a single provider change in ai-orchestration/src/agents/code.agent.js. Bring your own key, bring your own model, bring your own cost profile. Nothing about the agent loop, its tools, or its access to your sandbox changes when you switch providers.


Tech stack

React Vite Monaco Node.js Express Socket.IO Kubernetes Docker Skaffold AWS EKS MongoDB Redis RabbitMQ LangChain Mistral AWS S3

Frontend to filesystem, every layer of INKz is real production tech: not toy tooling. React and Vite for the client, Monaco for the editor itself, Express and Socket.IO for the real-time layer, Kubernetes and Skaffold for orchestration, MongoDB/Redis/RabbitMQ for state and messaging, and LangChain sitting on top of a pluggable LLM backend.


Self-host it, 100% free

Every cloud dependency in INKz has a zero-cost local swap: no AWS account, no managed database, no credit card:

Cloud service Free local swap
AWS S3 MinIO (Docker)
MongoDB Atlas mongo:7 (Docker)
Redis Cloud redis:7 (Docker)
CloudAMQP rabbitmq:3-management (Docker)
Any paid LLM API Ollama, running fully offline

Skip auth and notification entirely on an 8GB laptop to save roughly 2.5GB of RAM and still get sandboxes, editing, S3 sync, and the AI agent working end to end: the core loop doesn't need Google login or email to function.


Go deeper

Architecture Docs Self-Host Guide DeepWiki

Architecture Docs: pod anatomy, the exact Redis TTL state machine, RabbitMQ event flow, LangChain tool loop, and request-by-request sequence diagrams. Self-Host Guide: secrets explained one by one, MongoDB/Redis/RabbitMQ options, Ollama model picks by RAM, low-RAM mode, and the AWS EKS production path. DeepWiki: an AI-generated, browsable map of the entire codebase if you want to explore the source without cloning it first.


Built with 🔥 by Harsh Patel

Solo-engineered end to end: 5 microservices, Kubernetes control plane, and an autonomous AI agent.


GitHub Repository LinkedIn License: MIT


Released under the MIT License. Free & Open Source for everyone.

About

Cloud IDE + autonomous AI coding agent - Kubernetes-powered instant dev sandboxes with LangChain ReAct agent that reads, writes & ships multi-file code changes in your browser.

Topics

Resources

Contributing

Security policy

Stars

15 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages