Home

JoyBoy Wiki

JoyBoy is an open-source, local-first AI workstation and runtime harness.

The goal is to bring local chat, Ollama models, image generation, image editing, inpainting, model imports, local packs, runtime jobs, and project-oriented agent workflows into one app that stays understandable and hackable.

This wiki tracks the product direction, runtime decisions, hardware goals, and contribution areas.

Start here

• Roadmap - what JoyBoy is trying to become and what needs to be stabilized next.
• Project Mode - the Codex-style workspace mode currently in development.
• Hardware and VRAM - low-VRAM goals, tested configurations, and what still needs validation.
• Local Packs - how optional local extensions should stay separate from the public core.

Current focus

JoyBoy is still moving fast. The main priority is not adding random features, but making the core runtime stable enough that users can trust it during long local sessions.

The near-term focus is:

• Make image, chat, video, and project-mode jobs easier to stop, resume, inspect, and recover.
• Make the Codex-style project mode reliable enough for real repository work.
• Keep improving 8GB VRAM behavior without breaking larger GPUs.
• Validate how the runtime behaves on 12GB, 16GB, 24GB, and higher VRAM machines.
• Keep the public core neutral while allowing optional local packs to extend workflows.

Contribution style

Useful contributions are very welcome, especially small fixes that improve reliability, translations, model/runtime UX, documentation, first-run setup, or hardware compatibility.

If you are new to the project, start with GitHub issues tagged for first contributions.