THON: An Orchestrator for Multi-Person Collaborative Development Environments in Hackathons

THON is an open-source project designed to provide one-click deployed multi-user VS Code sandbox environments for hackathons and technical events. It supports SSL reverse proxy, user group management, persistent workspaces, and optional local LLM inference capabilities, solving issues like environment inconsistency, data privacy, and cost in traditional development environment configurations, and offering a self-hosted unified solution.

In scenarios such as hackathons and programming workshops, organizers often face the challenge of quickly setting up unified, isolated, and secure development environments. Traditional solutions either require participants to configure their own environments (leading to inconsistency) or rely on cloud IDEs (raising data privacy and cost issues). THON (The Hackathon Organizer Node), as an open-source tool, provides a self-hosted solution that can quickly deploy multiple independent pre-configured VS Code sandboxes on a server, supporting persistent storage and local AI assistance features.

THON adopts a modular architecture with core components including:

1. Unified CLI Entry: Simplifies the deployment process via thon init/setup/run commands and the thon.yaml configuration file.
2. Multi-instance Sandbox Management: Runs multiple code-server instances based on Docker, exposing HTTPS endpoints through nginx reverse proxy.
3. User and Group System: Uses YAML to configure groups, assign resource quotas and permissions, suitable for hierarchical management scenarios.
4. Persistent Workspace: Supports three storage modes: PVC volume, bind mount, and temporary.
5. SSL/TLS Automatic Configuration: Two certificate generation modes: mkcert (recommended) and openssl.
6. Local LLM Integration: Provides chat completion, text embedding, and other capabilities via Lemonade Server; optional APISIX AI gateway for rate limiting.

THON offers two management methods:

• Streamlit Web Dashboard (port 8501): Visually manages instances, groups, LLM services, and gateway configurations.
• FastAPI REST API (port 8100): Enables programmatic access with automatically generated Swagger documentation, easy to integrate into automated workflows.

THON is suitable for the following scenarios:

1. Hackathons: Quickly assign pre-configured environments, supporting multi-language frameworks.
2. Programming Teaching: Standardize student environments to ensure consistent toolchains.
3. Enterprise Internal Training: Deploy in internal networks to meet the security requirement that data does not leave the domain.
4. Remote Collaboration: Provide unified cloud workstations for distributed teams.

THON is optimized for Kilo Code (an AI programming assistant), which can automatically generate a kilo.json file containing experimental flags and semantic index configurations, allowing each sandbox instance to gain AI-assisted programming capabilities without additional configuration.

The value of THON lies in lowering the threshold for organizing technical events, shifting environment configuration from individual solutions to unified provision by organizers. Integration with Lemonade Server demonstrates the construction of locally AI-enhanced development environments, suitable for data privacy or offline scenarios. In the future, it will continue to evolve, supporting more IDE types, fine-grained permission control, and richer AI integration options.