302 AI Studio is a desktop client supporting multiple LLM service providers, compatible with Windows, Mac, and Linux.
Home chat interface, providing input box, toolbar, model selection, and quick access to commonly used AI tools

Multi-tab chat interface with conversation list on the left and chat window on the right

Quickly open AI applications within the client, no need to visit websites

Settings page in standalone window, including General, Account, Preferences, MCP, and other common configurations

Agent management page, supports switching between remote/local platforms and viewing/managing the list of agent sandboxes

- π€ Support for OpenAI, Anthropic, Google, and other major AI providers
- π Flexible model switching and configuration
- ποΈ Advanced conversation parameter controls (temperature, top-p, token limits, etc.)
- π MCP (Model Context Protocol) server integration
- πΌοΈ Upload images for AI-assisted content analysis and description generation
- π Support for multiple file formats
- π» Code syntax highlighting
- π Mermaid diagram visualization
- π Full Markdown rendering support
- π₯οΈ Multi-platform support for Windows, Mac, and Linux
- π Customizable light/dark theme system with real-time preview
- π€ Support account login, and allows checking balance and usage
- π Complete Markdown rendering
- π± Responsive design, perfectly adapts to various screen sizes
- π¨ Modern component library based on Shadcn-Svelte
- ποΈ Manage multiple conversation threads simultaneously, organized and clear
- β‘ Support for real-time streaming responses
- β¨οΈ Complete keyboard shortcut system
- π Hot Module Replacement (HMR) support for smooth development experience
- π€ Invoke Claude Code via remote sandbox environments for intelligent task planning
- π― Agent task execution and real-time monitoring, track task progress and status
- π Intelligent workflow management, supporting complex task decomposition and collaboration
- π Agent session statistics and analysis, view execution history and performance data
- π One-click full-stack application deployment, Agent automatically writes, tests, and deploys code
- π¦ Support for multiple tech stacks, quickly build web applications, API services, and more
- δΈζ
- English
- ζ₯ζ¬θͺ(coming soon)
[v25.50.8] Added Agent mode; added quick login and account configuration
π‘ For the complete update history, please visit GitHub Releases
| Layer | Technology | Description |
|---|---|---|
| UI Layer | SvelteKit 5 + TypeScript | Modern component development, type safety, reactive state management |
| Style Layer | TailwindCSS 4.x + Custom Theme System | Atomic CSS + smooth animations |
| Desktop | Electron 38 | Cross-platform desktop application framework |
| State Management | Svelte 5 Runes | Reactive state management ($state, $derived) |
| UI Component Library | Shadcn-Svelte (bits-ui) | Modern, accessible component library |
| Internationalization | Inlang Paraglide-js | Multi-language support |
| AI Integration | AI SDK | Unified AI provider interface |
| Build Tools | Vite + Electron Forge | Fast build + hot reload |
| Type System | TypeScript | Strict type checking |
| Code Quality | ESLint + Prettier + Vitest + Playwright | Code standards + unit tests + E2E tests |
- Operating System: Windows 10+ / macOS 10.14+ / Linux (Ubuntu 18.04+)
- Node.js: 18.x or higher
- Package Manager: pnpm 10.18.3+ (required)
- Memory: 4GB RAM (8GB+ recommended)
- Storage: 500MB available space
- Network: Stable internet connection (to access AI provider APIs)
# 1οΈβ£ Clone the project
git clone https://github.com/302ai/302-AI-Studio-sv.git
cd 302-AI-Studio-sv
# 2οΈβ£ Install dependencies
pnpm install
# 3οΈβ£ Start the development server π
pnpm devWarning
This project must use pnpm as the package manager. The project includes necessary patches for SvelteKit, and other package managers may not work properly.
# Start development server (with hot reload)
pnpm dev
# Type checking
pnpm check
# Code linting
pnpm lint
# Auto-fix linting issues
pnpm lint:fix
# Format code
pnpm format
# Check code formatting
pnpm format:check
# Complete quality check
pnpm quality
# Auto-fix all issues
pnpm quality:fix# Run unit tests
pnpm test:unit
# Run E2E tests
pnpm test:e2e
# Run all tests
pnpm test# Build SvelteKit application
pnpm build
# Package Electron app (output in /out directory)
pnpm package
# Create distributable installer
pnpm make
# Publish to configured targets
pnpm publish| Platform | Architecture | Status |
|---|---|---|
| Windows | x64 / ARM64 | β Fully Supported |
| macOS | x64 / Apple Silicon | β Fully Supported |
| Linux | x64 / ARM64 | β Fully Supported |
π¦ 302-AI-Studio-sv
βββ π src/ # Renderer process source code
β βββ π lib/ # Shared libraries
β β βββ π components/ # UI components
β β β βββ ui/ # Shadcn-Svelte base components (40+)
β β β βββ buss/ # Business components
β β β βββ chat/ # Chat interface
β β β βββ model-*/ # Model selection and configuration
β β β βββ provider-*/ # AI provider management
β β β βββ theme-*/ # Theme system
β β β βββ settings/ # Application settings
β β βββ π stores/ # State management (Svelte 5 Runes)
β β βββ π types/ # TypeScript type definitions
β β βββ π api/ # API integration layer
β β βββ π utils/ # Utility functions
β β βββ π theme/ # Theme system
β β βββ π datas/ # Static data
β β βββ π hooks/ # Svelte Hooks
β βββ π routes/ # Routes
β β βββ (with-sidebar)/ # Main application layout
β β β βββ chat/ # Chat interface routes
β β βββ (settings-page)/ # Settings page layout
β β β βββ settings/ # Settings route groups
β β βββ shell/ # Shell window routes
β βββ π shared/ # Cross-process shared code
β β βββ storage/ # Persistent storage
β β βββ types/ # Shared types
β βββ π messages/ # Internationalization message files
β βββ π app.html # HTML template
βββ π electron/ # Electron main process
β βββ main/ # Main process code
β β βββ services/ # IPC services
β β βββ generated/ # Auto-generated IPC bindings
β β βββ constants/ # Electron constants
β βββ preload/ # Preload scripts
βββ π vite-plugins/ # Custom Vite plugins
β βββ ipc-service-generator/ # IPC service generator
βββ π scripts/ # Build scripts
βββ π docs/ # Documentation
βββ π e2e/ # Playwright E2E tests
βββ π package.json # Project configuration
We welcome all forms of contributions! Whether it's reporting bugs, suggesting new features, or submitting code improvements.
- Code Contributions: Submit PRs to improve the code
- Bug Fixes: Submit fixes for issues you've discovered
- Feature Suggestions: Have a great idea? We'd love to hear your suggestions
- Documentation: Help us improve documentation and usage guides
- Promotion: Spread the word about 302 AI Studio
# 1. Fork the project
# 2. Create a feature branch
git checkout -b feature/amazing-feature
# 3. Commit changes (following Conventional Commits)
git commit -m 'feat: add amazing feature'
# 4. Push to the branch
git push origin feature/amazing-feature
# 5. Create a Pull RequestEncountering issues? Please provide feedback in GitHub Issues
Have feature suggestions? We're waiting for you in GitHub Discussions
This project is open source under AGPL-3.0, you are free to use, modify, and distribute it.
302.AI is a pay-as-you-go AI application platform that solves the last-mile problem of applying AI in practice.
- π§ Comprehensive collection of the latest and most complete AI capabilities and brands, including but not limited to language models, image models, audio models, and video models
- π Deep application development based on foundation models, developing real AI products rather than simple chatbots
- π° Zero monthly fees, all features are pay-as-you-go, fully open, truly low barriers with high ceilings
- π οΈ Powerful management backend, targeting teams and small-to-medium enterprises, one person manages, multiple people use
- π All AI capabilities provide API access, all tools are open source and customizable (in progress)
- π‘ Strong development team, launching 2-3 new applications weekly, with daily product updates. Developers interested in joining are welcome to contact us

