Skip to content

DexWorks/osw-studio

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

91 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

OSW Studio Logo

Open Source Web Studio

Build websites through natural language conversations with agentic AI

GitHub Stars License Live Demo Version PRs Welcome Discord

Try it Now Β· Documentation Β· Discord Β· GitHub


OSW Studio Demo

Overview

OSW Studio is an AI-powered development platform where you build and maintain websites and web apps through natural language conversations.

Static sites have always been fast, cheap to host, and secure. The tradeoff was that maintaining them required technical skill. OSW Studio removes that tradeoff - describe what you want, and AI handles the implementation.

For developers: Skip the boilerplate. Rapid prototyping, full code access when you need it, and an AI that understands your project's context.

For everyone else: Finally maintain the site that was built for you. Add blog posts, update business hours, swap team photos - without filing a support ticket or hiring an agency.

What you get:

  • Multiple runtimes - Static (HTML/CSS/JS), Handlebars (templated websites), React, Preact, Svelte, Vue, Python, Lua
  • Sandboxed agent - AI operates in a virtual file system with automatic checkpoints - explore freely, rollback anytime
  • Dual AI modes - Chat (exploration, planning) + Code (full implementation)
  • Multi-provider AI - OpenRouter (200+ models), OpenAI, Anthropic, Google Gemini, Groq, HuggingFace, MiniMax, Zhipu AI, SambaNova, Ollama, LM Studio, llama.cpp
  • Full IDE - Monaco editor, live preview, file explorer, multi-tab support
  • Templates & Skills - Reusable project templates (with bundled backend infrastructure) and AI workflow guides
  • Export anywhere - Download as ZIP, deploy to Vercel/Netlify/GitHub Pages
  • Optional Server Mode - Self-host a multi-site publishing platform with built-in SEO, analytics, and admin dashboard

Perfect for: Business websites, landing pages, portfolios, documentation sites, blogs, React apps, interactive tools

Two modes: Browser Mode (build and export as ZIP) or Server Mode (self-hosted platform with databases, APIs, and publishing)

πŸš€ Quick Start

Get started in 3 steps:

# 1. Clone and install
git clone https://github.com/o-stahl/osw-studio.git
cd osw-studio
npm install

# 2. Start development server
npm run dev

3. Open browser and start building:

  1. βœ… Get an API key from OpenRouter, OpenAI, or run Ollama locally
  2. βœ… Open http://localhost:3000
  3. βœ… Click settings β†’ Select provider β†’ Enter API key
  4. βœ… Create project β†’ Describe your website
  5. βœ… Export as ZIP β†’ Deploy anywhere

Try the hosted version: Live Demo (no installation required)

Key Features

Development Environment

  • Monaco Editor - Full-featured code editor with syntax highlighting, IntelliSense
  • Live Preview - Hot reload, instant updates as AI builds
  • File Explorer - Tree view with right-click context menus
  • Multi-tab Support - Work on multiple files simultaneously
  • Handlebars Templates - Build reusable components with partials

AI Capabilities

  • Dual Modes:
    • πŸ’¬ Chat Mode - Exploration, planning, Q&A
    • πŸ”§ Code Mode - Full implementation with file operations
  • 12 LLM Providers - OpenRouter, OpenAI, Anthropic Claude, Google Gemini, Groq, HuggingFace, MiniMax, Zhipu AI, SambaNova, Ollama, LM Studio, llama.cpp
  • 200+ Models - From tiny 4B tool models to SOTA frontier models
  • Smart Agent - Uses shell commands for all file operations, with explicit build verification and status evaluation
  • Skills System - Teach AI your workflow preferences with Anthropic-style skills

Project Management

  • Templates - Export/import reusable project templates (.oswt files)
  • Checkpoints - Rollback to any point in conversation with per-message restore
  • Export Options - ZIP deployment packages or .osws backups (full history)
  • Project Gallery - Grid/list views with screenshots, search, sorting

What Can You Build?

βœ… Browser Mode Details
Landing Pages Marketing sites, product pages, SaaS homepages
Portfolios Personal websites, photography, design portfolios
Documentation Project docs, help centers, knowledge bases
Blogs Static blogs with templates and navigation
Framework Apps React, Preact, Svelte, Vue with in-browser bundling via esbuild
Scripts Python (Pyodide) and Lua (wasmoon) with interactive Console
Client-side Apps Calculators, tools, games, interactive demos
βœ… Server Mode Details
Dynamic Websites Contact forms, comment systems, user submissions via Edge Functions
Database-backed Apps CRUD apps, dashboards, admin panels with per-deployment SQLite
Blogs & CMS Static posts with Handlebars partials, comments via Edge Functions
API Backends REST APIs with database access, secrets management, auth flows
Multi-site Platform Host multiple deployments on one instance

See Server Mode for full details.

How It Works

OSW Studio uses an agentic AI system with a single tool:

  1. Shell Tool - File system operations and editing (ls, cat, grep, find, mkdir, rm, mv, cp, sed -i, cat >, echo >, tree, head, tail, build, status)

The status command signals task completion β€” the AI must articulate what it did and what remains before finishing.

Command validation β†’ Execution β†’ Checkpoint β†’ Continue

The agent runs entirely in your browser, operating on a virtual file system (IndexedDB). You describe what you want, AI handles the implementation.

Model Recommendations

βœ… Recommended Models (Tool Calling)

  • Gemini 3 - Good pricing, speed and quality, best value currently
  • Haiku 4.5 - Reasonable pricing, speed and quality
  • GLM4.7, GLM4.6, GLM4.5 & air - Fast, reliable and cheap, among SOTA for webdev
  • Grok Code Fast 1 - Good balance of speed, quality and price
  • Kimi K2 - Good balance of speed, quality and price
  • gpt-oss-120b & 20b - Strong agentic capabilities
  • Qwen3 series - Some models perform better than others, but functional across the board
  • DeepSeek v3.2, v3.1 and R1 - Can handle most tasks, but not optimized for this use case
  • Claude Sonnet 4.5 & Opus 4.5 - Good, but can rack up a large bill quickly (Gemini 3 is much better value)
  • SOTA models - Generally SOTA models will perform, but come with a higher pricing

⚠️ Models Without Tool Calling (JSON Parsing Fallback)

  • DeepSeek V3, Qwen2.5, Gemma3, Mistral-small, Granite 3.x, Llama4 Maverick/Scout

Rule of thumb: A 4B tool-calling model typically outperforms a 70B non-tool model for this use case. Models released after summer 2025 should work well.

Supported Providers

Local (Free, Private):

Cloud:

File Support

Type Formats Limits
Code HTML, CSS, JS/JSX, TS/TSX, JSON, HBS, Svelte, Vue, Python, Lua 5MB per file
Docs TXT, MD, XML, SVG 5MB per file
Media PNG, JPG, GIF, WebP, MP4, WebM 10MB images, 50MB video

Server Mode (Optional)

OSW Studio runs client-side by default (Browser Mode). For advanced use cases, enable Server Mode:

Browser Mode (Default)

  • βœ… Client-side only, no backend required
  • βœ… IndexedDB storage (stays in browser)
  • βœ… Deploy to Vercel, Netlify, HuggingFace
  • βœ… Complete privacy
  • βœ… Zero configuration

Server Mode (Optional)

  • βœ… SQLite persistence (no external database setup)
  • βœ… Admin authentication (JWT sessions)
  • βœ… Static site publishing to /deployments/{deploymentId}/
  • βœ… Edge Functions - JavaScript API endpoints with database access
  • βœ… Scheduled Functions - Run edge functions on cron schedules
  • βœ… Per-deployment SQLite databases (WAL mode) with SQL editor
  • βœ… Secrets management (AES-256-GCM encrypted)
  • βœ… SEO controls - Meta tags, Open Graph, Twitter Cards, auto-sitemap
  • βœ… Built-in analytics (privacy-focused) or external (GA4, Plausible)
  • βœ… Compliance - Cookie consent banners with GDPR/CCPA support
  • βœ… Custom scripts - Inject head/body scripts, CDN resources
  • βœ… Project sync (IndexedDB ↔ SQLite)
  • βœ… Custom domains via reverse proxy
  • βœ… Site Templates - Create from templates with automatic backend provisioning
  • βœ… Blog template - Static posts with Handlebars partials, ready for comments

Quick Start (Server Mode):

# 1. Configure .env
NEXT_PUBLIC_SERVER_MODE=true
SESSION_SECRET=$(openssl rand -base64 32)
ADMIN_PASSWORD=your_secure_password
ANALYTICS_SECRET=$(openssl rand -base64 32)
SECRETS_ENCRYPTION_KEY=$(openssl rand -base64 32)

# 2. Start server (SQLite databases created automatically)
npm install && npm run dev

# 3. Access at http://localhost:3000/admin/login

Documentation:

Tech Stack

  • Framework: Next.js 15.3.3, React 19, TypeScript
  • UI: TailwindCSS v4, Radix UI primitives
  • Editor: Monaco Editor (VS Code engine)
  • Storage: IndexedDB (browser), SQLite (server mode)
  • AI: 12 LLM provider integrations
  • Templating: Handlebars.js for components
  • Export: JSZip for deployment packages

Architecture

/components/       # React UI components (workspace, editor, preview)
/lib/vfs/          # Virtual file system with checkpoints
/lib/llm/          # AI orchestration, tool execution, providers
/app/api/          # API routes (generation, models, validation)
/docs/             # Comprehensive documentation

Debugging

Environment Variables

Create .env:

# Log level: error, warn, info, debug (default: warn)
NEXT_PUBLIC_LOG_LEVEL=warn

# Tool streaming debug (default: 0)
NEXT_PUBLIC_DEBUG_TOOL_STREAM=0

Troubleshooting

  • Generation fails β†’ Check DevTools console (F12)
  • Model compatibility β†’ Test at /test-generation
  • Tool issues β†’ Enable DEBUG_TOOL_STREAM=1
  • Rate limits β†’ Watch for toast notifications
  • Local providers β†’ Ensure Ollama/LM Studio running

Privacy

  • API keys - Stored in browser localStorage (never sent to OSW Studio servers)
  • Network calls - Direct to AI providers or via optional proxy endpoints
  • Data storage - Projects stay in IndexedDB (browser mode) or SQLite (server mode)
  • Complete privacy - Use Ollama/LM Studio for 100% local operation
  • Anonymous telemetry - Lightweight usage analytics (page views, provider/model selection, task success rates) help improve OSW Studio. No prompts, code, file names, or API keys are ever collected. A random anonymous ID in localStorage counts unique visitors β€” no cookies, no fingerprinting. Opt out anytime in Settings, or disable entirely with NEXT_PUBLIC_TELEMETRY_ENABLED=false

Note: Remote LLM providers (OpenAI, Anthropic, etc.) will receive your code during generation. For complete privacy, use local models.

Limitations

  • No package managers - Static projects use CDN links for libraries; framework projects (React, Preact, Svelte, Vue) auto-resolve npm imports via esm.sh
  • Browser Mode - Client-side projects only, no backend (use Server Mode for APIs/databases)

Contributing

OSW Studio is a solo-maintained, community-driven project. Contributions welcome!

Ways to help:

Built something cool? I'd love to see it! Share your creations in GitHub Discussions or open an issue with screenshots.

β˜• Support

If OSW Studio saved you time or helped with a project, consider supporting development:

β˜• Buy me a coffee

License

MIT License - See LICENSE file for details

πŸ™ Credits

Original Inspiration:

Technical Inspiration:

Special Thanks:

  • All open source contributors making projects like this possible
  • The AI community for pushing boundaries

Note: OSW Studio is not affiliated with Anthropic, OpenAI, Google, Hugging Face, or other mentioned organizations. All trademarks belong to their respective owners.

About

Agentic BYOK Browser-Based Website Builder

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 99.4%
  • Other 0.6%