hoplight

Hoplight is a local-first studio for AI-roleplay content creation and management. It addresses the fragmented format ecosystem across platforms like SillyTavern, RisuAI, RoleCall, Backyard, Agnai, Pygmalion, Lumiverse, Marinara, Chub, and NovelAI by maintaining one canonical model in the middle and providing one adapter per platform. The core thesis is that users create, edit, and keep their work in a studio linked to no platform, publishing into a platform's format only when chosen. Content—characters, lorebooks, personas, presets, regex sets, and sprite packs—lives as plain JSON files in a user-controlled folder rather than being scattered across consuming apps. Hoplight's primary surfaces include: - Library: handles import, organization, and batch selection with grid, showcase, list, and gallery views - Workbench: contains editors for canonical fields with platform-specific tabs and a lens showing target coverage while writing - Binder: the lorebook editor with table of contents, trigger/logic editing, budget estimates, health checks, and an activation simulator - Press: turns staged pieces into target files with readiness checks and honest result reports showing what was exported, retained, or unsupported On import, Hoplight maps content into a canonical piece and stores the original source plus unmapped platform fields in escrow, ensuring no data is discarded. On export, adapters write the target format and report coverage gaps. Same-format round trips must meet declared fidelity tiers verified by real fixtures. Safety features include local-first fail-closed design, loopback-only server binding by default, schema-validated input, hard size limits on archives, and sealed scripts—Lua, macros, and regex rules are treated as data during import/conversion/storage/export, with execution only available in explicit isolated test benches. The CLI provides commands for inspecting, validating, labeling, converting, listing formats, and starting the visual Studio. An interactive TUI called Kit is in active development. The project is built with Bun and strict TypeScript, with the engine kept pure and effects at the edges. It is licensed under AGPL-3.0 and in active development.