The GUI had a mini service framework in src/gui/src/services/: a `Service` base class (definitions.js) with `construct`/`init`/`__on`/`context` magic, a `globalThis.services` string-keyed registry with a two-phase construct→init lifecycle and an `emit`/`__on_*` event bus, plus a frontend↔backend `service_script` bridge for registering extra services from the backend. Nothing used the extension bridge, and the framework added indirection over what are really just nine long-lived singletons. This flattens all of it: - Move the nine services to src/gui/src/modules/ as plain classes exporting a singleton (process, exec, ipc, broadcast, theme, debug, locale, anti-csrf). `__launch-on-init` becomes a plain `launch_on_init(gui_params)` function since nothing else references it. Method bodies are unchanged. - Cross-service access is now direct ES-module imports instead of `globalThis.services.get(name)`. No base class, no registry, no lifecycle phases, no event bus. The single `gui:ready` event becomes a direct `process_service.on_gui_ready()` call from UIDesktop. - launch_services() now just calls init() on the four modules that need runtime setup (exec/debug/theme/process), then runs launch_on_init. All singletons are constructed at import, so construct-before-init ordering is preserved. - Remove the `Service` base class from definitions.js. - Remove the unused `service_script` bridge from PuterHomepageService (the `window.service_script`/`service_script_api_promise` shim, `registerScript`, `#serviceScripts`, and the `serviceScriptTags` injection point). Verified: webpack GUI build and backend tsc both clean; homepage controller tests pass; booted the app and exercised the desktop, launching an SDK app (process registration) and the Task Manager (process tree) with no console errors.
The Open-Source Internet Computer!
« LIVE DEMO »
Puter.com
·
App Store
·
Developers
·
Discord
·
Reddit
·
X
Puter
Puter is an advanced, open-source, self-hostable internet computer designed to be feature-rich, fast, and highly extensible.
For Users
Puter's goal is to provide you with every app and feature you need to work, create, and play under one roof. From a simple Notepad and Voice Recorder to Spreadsheet and Camera, Puter wants to be the all-in-one solution for your digital life.
For Developers
Puter provides everything you need to build and publish web apps and games. From AI to Cloud Storage and Database to Serverless Workers, Puter has you covered. Puter also helps you get users! Once you build your app, you can publish it on our App Store to reach and monetize users.
Getting Started
💻 Local Development
git clone https://github.com/HeyPuter/puter
cd puter
npm install
npm start
→ This should launch Puter at http://puter.localhost:4100
🚀 Self-Hosting
Linux/macOS
curl -fsSL https://puter.com/selfhost | sh
Windows
irm https://puter.com/selfhost?os=windows | iex
→ For more details, see Self-Hosting Puter.
☁️ Puter.com
Puter is available as a hosted service at puter.com.
Support
Connect with the maintainers and community through these channels:
- Bug report or feature request? Please open an issue.
- Discord: discord.com/invite/PQcx7Teh8u
- X (Twitter): x.com/HeyPuter
- Reddit: reddit.com/r/puter/
- Mastodon: mastodon.social/@puter
- Security issues or abuse reports? security@puter.com
- Email maintainers at hi@puter.com
We are always happy to help you with any questions you may have. Don't hesitate to ask!
License
This repository, including all its contents, sub-projects, modules, and components, is licensed under AGPL-3.0 unless explicitly stated otherwise. Third-party libraries included in this repository may be subject to their own licenses.
Translations
- Arabic / العربية
- Armenian / Հայերեն
- Bengali / বাংলা
- Chinese / 中文
- Danish / Dansk
- English
- Farsi / فارسی
- Finnish / Suomi
- French / Français
- German / Deutsch
- Hebrew/ עברית
- Hindi / हिंदी
- Hungarian / Magyar
- Indonesian / Bahasa Indonesia
- Italian / Italiano
- Japanese / 日本語
- Korean / 한국어
- Malay / Bahasa Malaysia
- Malayalam / മലയാളം
- Polish / Polski
- Portuguese / Português
- Punjabi / ਪੰਜਾਬੀ
- Romanian / Română
- Russian / Русский
- Spanish / Español
- Swedish / Svenska
- Tamil / தமிழ்
- Telugu / తెలుగు
- Thai / ไทย
- Turkish / Türkçe
- Ukrainian / Українська
- Urdu / اردو
- Vietnamese / Tiếng Việt

