https://github.com/hectorpulido/pequeroku

A lightweight container management platform empowering community members to spin up isolated Docker environments for experiments and learning. 🚀
https://github.com/hectorpulido/pequeroku

backend

Last synced: 8 months ago
JSON representation

A lightweight container management platform empowering community members to spin up isolated Docker environments for experiments and learning. 🚀

• Host: GitHub
• URL: https://github.com/hectorpulido/pequeroku
• Owner: HectorPulido
• License: mit
• Created: 2025-06-09T17:19:37.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-23T17:55:10.000Z (about 1 year ago)
• Last Synced: 2025-06-23T18:42:49.475Z (about 1 year ago)
• Topics: backend
• Language: Python
• Homepage:
• Size: 1.35 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🧩 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



  


  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**](https://github.com/HectorPulido/pequeroku/wiki)

## 🧩 Quick Start

1. Follow the setup guide on the [**Wiki → Getting Started**](https://github.com/HectorPulido/pequeroku/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](https://github.com/HectorPulido/pequeroku/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

* 🌐 [pequeroku.net](https://pequeroku.net)

* 💻 [GitHub Wiki](https://github.com/HectorPulido/pequeroku/wiki)

* 🧠 [Medium Article](https://medium.com/p/19bc757c735d)

* 📦 License: MIT

## License

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



Let's connect 😋