Skip to content

Koba42Corp/opentang

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

68 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

OpenTang



Your stack. Your rules.

The open-source, cross-platform desktop app that bootstraps your complete self-hosted AI and developer infrastructure β€” in minutes, not days.

License Platform Built with Tauri Version Status

Think: Homebrew meets Docker Desktop meets an AI-native App Store.


What is OpenTang?

OpenTang is a guided desktop installer that takes you from zero to a fully running self-hosted AI and developer stack. No YAML wrangling. No terminal gymnastics. Just pick what you want, click install, and go.

It handles Docker orchestration, credential generation, SSL configuration, and service health β€” all through a clean, step-by-step wizard with an orange-fire dark UI.

Built for:

  • Developers setting up a personal AI/dev environment
  • Self-hosters who know Docker but hate config sprawl
  • Teams bootstrapping shared infrastructure
  • Anyone who wants local LLMs + AI agents running in minutes

Features

  • πŸ§™ Step-by-step wizard β€” guided setup from system check to running services
  • πŸ€– AI-first β€” install OpenClaw, Hermes, or NanoClaw with one click
  • 🧠 Local or cloud LLM β€” bundle Ollama for local models, or bring your own OpenAI/Anthropic key
  • 🐳 Docker-powered β€” everything runs in containers, managed by Compose
  • πŸ”’ Secure by default β€” auto-generated strong passwords, Traefik + Let's Encrypt SSL
  • πŸ“¦ In-app store β€” install, update, and remove services after initial setup
  • 🌐 Any network mode β€” localhost, LAN, or internet-facing with auto SSL
  • πŸ–₯️ Cross-platform β€” Windows (WSL2), macOS (Intel + Apple Silicon), Linux
  • πŸ”„ Auto-updates β€” app and package registry update independently

Included Stack

Core (always installed)

Service Purpose
Docker Container runtime
Traefik Reverse proxy + automatic SSL
Coolify Self-hosted PaaS β€” manages all deployments

Tier 1 β€” Recommended (default on)

Service Purpose
OpenClaw / Hermes / NanoClaw AI agent system (you choose)
Ollama Local LLM runtime (or skip and use API keys)
Gitea Private Git server
Portainer Docker management UI
Grafana + Prometheus Monitoring & observability

Tier 2 β€” Optional (via App Store)

Service Purpose
n8n Workflow automation
Vault Secrets management
Uptime Kuma Uptime monitoring
Vaultwarden Self-hosted Bitwarden
Nextcloud Cloud storage
SearXNG Private search engine
+ more via registry Community-submitted packages

Install Flow

OpenTang walks you through 9 steps:

  1. Welcome β€” Launch the app, hit "Begin Setup"
  2. System Check β€” Auto-detects OS, Docker, RAM, disk. Offers to fix missing deps
  3. Choose Edition β€” NanoClaw (light) / Hermes (balanced) / OpenClaw (full)
  4. LLM Config β€” Install Ollama locally, enter a cloud API key, or skip
  5. Package Selection β€” Toggle services on/off with live resource estimates
  6. Network Setup β€” Local only, LAN, or internet-facing with domain + SSL
  7. Security β€” Auto-generated credentials, copy/save, optional Vault
  8. Install β€” Step-by-step progress with per-service status and log viewer
  9. Done β€” Summary, quick-access URLs, "Open Dashboard" button

Quick Start

Download

Grab the latest release for your platform:

Prerequisites

Requirement Details
Docker Get Docker β†’ β€” OpenTang can auto-install on Linux; on macOS, use Docker Desktop or OrbStack
Windows only WSL2 enabled β€” OpenTang will prompt to install if missing
RAM 4GB minimum, 8GB+ recommended
Disk 10GB minimum, 40GB+ recommended for full stack

Note: OpenTang checks all prerequisites on launch and will guide you through installing anything that's missing.


Development

Requirements

Setup

git clone https://github.com/Koba42Corp/opentang.git
cd opentang
npm install

Run in development

npm run tauri:dev

This starts the Vite dev server with hot-reload and launches the Tauri window.

Build for production

npm run tauri:build

Outputs platform-specific installers to src-tauri/target/release/bundle/.

Available scripts

Command Description
npm run dev Start Vite dev server only (no Tauri)
npm run build TypeScript check + Vite production build
npm run tauri:dev Full dev mode with Tauri window
npm run tauri:build Production build with installers
npm run generate-icons Generate Tauri app icons
npm run lint TypeScript type check

Tech Stack

Layer Technology
Desktop framework Tauri v2 (Rust + native WebView)
Frontend React 18 + TypeScript
Styling Tailwind CSS
State Zustand
Icons Lucide React
Fonts Inter + JetBrains Mono
Orchestration Docker Compose v2
Package registry JSON manifests over HTTPS
Auto-update Tauri Updater via GitHub Releases

Project Structure

opentang/
β”œβ”€β”€ src/                    # React frontend
β”‚   β”œβ”€β”€ components/         # UI components (wizard, store, dashboard)
β”‚   β”œβ”€β”€ store/              # Zustand state management
β”‚   β”œβ”€β”€ types/              # TypeScript type definitions
β”‚   β”œβ”€β”€ App.tsx             # Root app component
β”‚   β”œβ”€β”€ main.tsx            # Entry point
β”‚   └── index.css           # Global styles + design tokens
β”œβ”€β”€ src-tauri/              # Rust backend (Tauri)
β”‚   β”œβ”€β”€ src/                # Commands, compose engine, system checks
β”‚   └── tauri.conf.json     # Tauri app configuration
β”œβ”€β”€ packages/               # Docker Compose templates per service
β”œβ”€β”€ registry/               # Package manifest (mirrors remote)
β”œβ”€β”€ scripts/                # Build helpers (icon generation, etc.)
β”œβ”€β”€ dist/                   # Vite build output
β”œβ”€β”€ PRD.md                  # Product requirements document
β”œβ”€β”€ BUILD_CHECKLIST.md      # Development progress tracker
β”œβ”€β”€ DESIGN_SYSTEM.md        # UI design tokens and component specs
β”œβ”€β”€ CONTRIBUTING.md         # Contribution guidelines
└── LICENSE                 # Apache 2.0

Package Registry

After initial setup, OpenTang stays running as a service management layer. The in-app store lets you:

  • Browse and install new packages (official + community)
  • Update or remove installed services
  • View container health and logs
  • One-click restart/stop per service
  • Access ClawHub for OpenClaw skills and plugins

Packages are defined as versioned JSON manifests:

{
  "id": "n8n",
  "name": "n8n",
  "version": "1.0.0",
  "description": "Workflow automation",
  "category": "automation",
  "compose_url": "https://registry.opentang.koba42.com/packages/n8n/compose.yml",
  "min_ram_mb": 512,
  "tags": ["automation", "workflows", "nocode"]
}

Want to submit a package? See CONTRIBUTING.md.


Contributing

We welcome contributions! OpenTang is community-maintained under Apache 2.0.


Roadmap

Version Focus
v0.1.0 Wizard installer, system checks, Compose engine, core packages
v0.2.0 In-app App Store, ClawHub integration, community packages
v1.0.0 Full polish, all platforms tested, public launch

See BUILD_CHECKLIST.md for granular progress tracking.


License

Apache 2.0 β€” Β© 2026 Koba42 Corp


Website Β· Issues Β· Discussions Β· Contributing

Built with πŸ”Ά by Koba42

About

A starting place for aspiring devs, seasoned teams and nerds alike.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors