Skip to content

A lightweight container management platform empowering community members to spin up isolated QEMU environments for experiments and learning. πŸš€

License

Notifications You must be signed in to change notification settings

Genvio/pequeroku

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧩 PequeRoku

πŸ–₯️ Your own always-on, self-hosted codespace β€” with real VMs, full root, and zero setup friction.

πŸš€ What Is It?

PequeRoku is an open-source alternative to Replit or Codespaces that you can host yourself. It gives you real virtual machines (via QEMU/KVM), a web IDE, and persistent environments you can reach from any device β€” laptop, tablet, or phone.

No sandbox. No cold starts. No hidden limits. Just your own cloud dev environment, fully under your control.

πŸͺ„ Demo & Screenshots

PequeRoku Demo
Jump into your VM from any device β€” no setup, no waiting.

✨ Why It Exists

I built PequeRoku because I couldn’t find a remote dev platform that was:

  • πŸ§‘β€πŸ’» Open & self-hosted
  • πŸ”‘ Root-accessible (install whatever you want)
  • πŸ’‘ Always-on β€” no booting or waiting
  • 🌐 Accessible from anywhere
  • πŸ’Έ Affordable to run at home

Traditional solutions like Replit, Codespaces, or Gitpod are great β€” but they don’t give you full control, and their costs add up fast. PequeRoku brings that freedom back.

βš™οΈ How It Works

Each PequeRoku instance runs:

  • 🧠 FastAPI backend for VM orchestration
  • 🧩 Django/DRF backend for users and templates
  • πŸ’Ύ QEMU VMs with strong isolation
  • πŸ’» Monaco + Xterm.js frontend for the IDE
  • 🧍 Each developer gets a persistent VM β€” always on, with root access.

πŸ“˜ Full architecture and setup guide β†’ Wiki

🧩 Quick Start

  1. Follow the setup guide on the Wiki β†’ Getting Started
  2. Launch your instance (Docker Compose supported)
  3. Visit http://localhost:8000
  4. Log in and start coding ✨

That’s it. You now have your own self-hosted Replit-style workspace.

🧠 What’s Next

  • ⚑ Fast snapshots / rollbacks
  • πŸ‘₯ Multi-user roles and guardrails
  • πŸ€– Automations (push β†’ test in active VM)
  • 🧰 Better UI for managing multiple instances
  • ✨ More AI

πŸ’¬ Contribute

PequeRoku is open to ideas, bug reports, and pull requests! If you’d like to help:

  • Check the Issues
  • Share feedback, ideas, or problems β€” I reply to everything πŸš€

🧑 Support the Project

If PequeRoku resonates with you:

  • ⭐ Star the repo β€” it helps others discover it
  • πŸ—£οΈ Tell others, spread the world
  • πŸ§‘β€πŸ’» Deploy it in your homelab and share your setup

PequeRoku isn’t β€œthe ultimate platform.” It’s your platform β€” a small way to take back control.

πŸ“Ž Links

License

This project is distributed under the MIT License. See the LICENSE file for details.

Let's connect πŸ˜‹

Hector's LinkedIn Β  Β  Hector's Twitter Β  Β  Hector's Twitch Β  Β  Hector's Youtube Β  Β  Pequesoft website Β  Β 

About

A lightweight container management platform empowering community members to spin up isolated QEMU environments for experiments and learning. πŸš€

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 59.5%
  • TypeScript 32.9%
  • HTML 4.1%
  • CSS 2.0%
  • JavaScript 1.0%
  • Shell 0.3%
  • Dockerfile 0.2%