Skip to content

Create a stable public demo instance for go-dav-os #164

Description

@dmarro89

Goal

Create a stable public demo for go-dav-os that interested users can try directly from a browser by opening a link.

The goal is to make the project easier to explore without requiring users to clone the repository, build the toolchain, create the ISO, or run QEMU locally.

Desired user experience

A user should be able to:

  1. Open a public URL.
  2. Access a running go-dav-os demo instance.
  3. Interact with the OS shell from the browser.
  4. Try basic commands such as:
help
version
ls
write demo hello
cat demo
history

If the v0.5.0 Agent work is available, the demo should eventually also allow trying:

agent help
agent show files
agent read demo
agent mode

Possible implementation directions

The implementation is intentionally open, but possible approaches include:

  • running QEMU on a small hosted VM and exposing the console through a browser terminal;
  • using a web terminal connected to a backend process that manages QEMU;
  • using noVNC/xterm.js or a similar browser-based console;
  • deploying a prebuilt ISO and booting it automatically;
  • providing a reset mechanism so every visitor can start from a clean state.

Requirements

  • The demo must be accessible through a public URL.
  • The demo should not require local installation.
  • The demo should boot a known stable build of go-dav-os.
  • The browser UI should expose an interactive console.
  • The instance should be resettable or isolated enough to avoid users breaking it for others.
  • The deployment process should be documented.
  • The chosen hosting option should be simple and reasonably low-cost.

Nice to have

  • Automatic rebuild/redeploy from main or from tagged releases.
  • A read-only/shared demo mode if full isolation is too expensive.
  • A visible banner explaining that this is an experimental hobby OS.
  • A short list of suggested commands in the web UI.
  • Support for the v0.5.0 Agent demo once the Agent runtime is merged.

Acceptance criteria

  • A public URL exists for the demo.
  • Users can access the demo from a browser.
  • The demo boots into go-dav-os without manual setup.
  • Users can type commands into the OS shell.
  • Basic shell commands work from the browser.
  • The instance can be reset or recreated safely.
  • Deployment steps are documented in the repository.
  • The README links to the public demo once available.

Notes

This issue is separate from the v0.5.0 Agent implementation, but it should eventually become the main way for contributors and curious users to try the project quickly.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    • Status
      Backlog

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions