Skip to content

302ai/302-AI-Studio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

302 AI Studio

302 AI Studio is a desktop client supporting multiple LLM service providers, compatible with Windows, Mac, and Linux.

δΈ­ζ–‡ | English | ζ—₯本θͺž

πŸ–ΌοΈ Interface Screenshots

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

🌟 Key Features

Multi-Model & Multi-Provider Support

  • πŸ€– 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

Document & Data Processing

  • πŸ–ΌοΈ 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

Excellent User Experience

  • πŸ–₯️ 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

Efficient Workflow

  • πŸ—‚οΈ 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

Agent Mode

  • πŸ€– 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

Multi-Language Support

  • δΈ­ζ–‡
  • English
  • ζ—₯本θͺž(coming soon)

πŸ“ Changelog

[v25.50.8] Added Agent mode; added quick login and account configuration

πŸ’‘ For the complete update history, please visit GitHub Releases


πŸ› οΈ Technical Architecture

πŸ—οΈ Core Technology Stack

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

πŸš€ Quick Start

πŸ“‹ System Requirements

  • 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)

⚑ Installation & Launch

# 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 dev

Warning

This project must use pnpm as the package manager. The project includes necessary patches for SvelteKit, and other package managers may not work properly.

πŸ“¦ Build & Deployment

πŸ”§ Development Commands

# 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

πŸ§ͺ Testing

# Run unit tests
pnpm test:unit

# Run E2E tests
pnpm test:e2e

# Run all tests
pnpm test

πŸš€ Production Build

# 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

πŸ“± Cross-Platform Support

Platform Architecture Status
Windows x64 / ARM64 βœ… Fully Supported
macOS x64 / Apple Silicon βœ… Fully Supported
Linux x64 / ARM64 βœ… Fully Supported

πŸ› οΈ Development Guide

πŸ“ Project Structure

πŸ“¦ 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

🀝 Contribution Guide

We welcome all forms of contributions! Whether it's reporting bugs, suggesting new features, or submitting code improvements.

πŸ’‘ Ways to Contribute

  1. Code Contributions: Submit PRs to improve the code
  2. Bug Fixes: Submit fixes for issues you've discovered
  3. Feature Suggestions: Have a great idea? We'd love to hear your suggestions
  4. Documentation: Help us improve documentation and usage guides
  5. Promotion: Spread the word about 302 AI Studio

πŸ“‹ Contribution Steps

# 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 Request

πŸ’¬ Contact Us

Website GitHub Email

Encountering issues? Please provide feedback in GitHub Issues

Have feature suggestions? We're waiting for you in GitHub Discussions

πŸ“„ License

This project is open source under AGPL-3.0, you are free to use, modify, and distribute it.

✨ About 302.AI

302.AI is a pay-as-you-go AI application platform that solves the last-mile problem of applying AI in practice.

  1. 🧠 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
  2. πŸš€ Deep application development based on foundation models, developing real AI products rather than simple chatbots
  3. πŸ’° Zero monthly fees, all features are pay-as-you-go, fully open, truly low barriers with high ceilings
  4. πŸ› οΈ Powerful management backend, targeting teams and small-to-medium enterprises, one person manages, multiple people use
  5. πŸ”— All AI capabilities provide API access, all tools are open source and customizable (in progress)
  6. πŸ’‘ Strong development team, launching 2-3 new applications weekly, with daily product updates. Developers interested in joining are welcome to contact us

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 6