Tổng quan dự án
Tệp nguồn liên quan
Trang này được tạo dựa trên các tệp nguồn sau:
Sim AI Platform là nền tảng mã nguồn mở được thiết kế để xây dựng AI agents và điều phối agentic workflows. Dự án cho phép kết nối hơn 1,000+ tích hợp và các mô hình LLM khác nhau, cung cấp giao diện trực quan để thiết kế workflow trên canvas. Với khả năng tích hợp vector databases, nền tảng hỗ trợ knowledge retrieval từ tài liệu được tải lên, cho phép agents trả lời câu hỏi dựa trên nội dung cụ thể của người dùng (README.md:1-25).
Nền tảng cung cấp ba tính năng chính: workflow builder trực quan cho phép thiết kế agent workflows bằng cách kết nối agents, tools và blocks; Copilot AI trợ giúp tạo nodes, sửa lỗi và lặp lại flows trực tiếp từ ngôn ngữ tự nhiên; và tích hợp vector databases để upload documents vào vector store (README.md:27-39).
Kiến trúc Hệ thống
正在加载图表渲染器...
Kiến trúc trên mô tả các layer chính của Sim AI Platform. Client layer sử dụng Next.js App Router kết hợp với ReactFlow cho canvas editor. Application layer xử lý API routes và realtime communication qua Socket.io. Services layer tích hợp Copilot AI assistant, Trigger.dev cho background jobs, và E2B cho remote code execution. Data layer sử dụng PostgreSQL với pgvector extension cho vector storage và Redis cho caching (README.md:175-189).
Công nghệ và Dependencies
Dự án sử dụng Next.js 16.1.6 với App Router làm framework chính, React 19.2.4 cho UI components. Runtime environment là Bun >=1.2.13 với Node.js >=20.0.0, cung cấp hiệu suất cao hơn so với Node.js truyền thống (apps/sim/package.json:1-29).
| Thành phần | Công nghệ | Phiên bản |
|---|---|---|
| Framework | Next.js | 16.1.6 |
| UI Library | React | 19.2.4 |
| Runtime | Bun | >=1.2.13 |
| Database ORM | Drizzle ORM | ^0.44.5 |
| Flow Editor | ReactFlow | ^11.11.4 |
| Realtime | Socket.io | ^4.8.1 |
| State Management | Zustand | ^4.5.7 |
| Styling | Tailwind CSS | ^3.4.1 |
| Authentication | Better Auth | - |
| LLM SDK | OpenAI | ^4.91.1 |
| Vector Database | PostgreSQL + pgvector | - |
Các dependencies chính được liệt kê chi tiết trong package.json, bao gồm integration với nhiều LLM providers (OpenAI, Anthropic, Groq), database drivers (PostgreSQL, MongoDB, MySQL, Neo4j), và utility libraries cho xử lý documents, emails, và media files (apps/sim/package.json:138-185).
Các tùy chọn Triển khai
正在加载图表渲染器...
Sơ đồ trên thể hiện các phương thức triển khai khác nhau của Sim AI Platform. Cloud-hosted tại sim.ai là giải pháp nhanh nhất, không yêu cầu cài đặt. Self-hosted có thể thực hiện qua NPM package với npx simstudio, Docker Compose với git clone, hoặc Dev Containers trong VS Code (README.md:41-72).
Đối với local AI models, dự án hỗ trợ Ollama với GPU support (tự động download gemma3:4b model) hoặc CPU-only systems. Cũng hỗ trợ vLLM cho self-hosted models bằng cách cấu hình VLLM_BASE_URL và VLLM_API_KEY (README.md:73-103).
Cấu hình Biến môi trường
| Biến | Bắt buộc | Mô tả |
|---|---|---|
DATABASE_URL | Có | PostgreSQL connection string với pgvector |
BETTER_AUTH_SECRET | Có | Auth secret (tạo bằng openssl rand -hex 32) |
BETTER_AUTH_URL | Có | URL ứng dụng (ví dụ: http://localhost:3000) |
NEXT_PUBLIC_APP_URL | Có | Public app URL |
ENCRYPTION_KEY | Có | Mã hóa environment variables |
INTERNAL_API_SECRET | Có | Mã hóa internal API routes |
API_ENCRYPTION_KEY | Có | Mã hóa API keys |
COPILOT_API_KEY | Không | API key từ sim.ai cho Copilot features |
Các biến môi trường trên là bắt buộc cho self-hosted deployments. COPILOT_API_KEY là tùy chọn, được lấy từ sim.ai → Settings → Copilot để sử dụng Copilot features trên self-hosted instance (README.md:153-174).
Yêu cầu hệ thống cho manual setup bao gồm Bun runtime, Node.js v20+, và PostgreSQL 12+ với pgvector extension. Có thể khởi tạo PostgreSQL với pgvector bằng Docker: docker run --name simstudio-db -e POSTGRES_PASSWORD=your_password -e POSTGRES_DB=simstudio -p 5432:5432 -d pgvector/pgvector:pg17 (README.md:111-127).
Cấu trúc Ứng dụng và Providers
正在加载图表渲染器...
Sequence diagram trên mô tả luồng khởi tạo ứng dụng từ request đến render. Layout.tsx đóng vai trò entry point, khởi tạo các providers theo thứ tự: PostHogProvider cho analytics, QueryProvider cho React Query state management, SessionProvider cho authentication, ThemeProvider cho dark/light mode, và TooltipProvider cho UI components (apps/sim/app/layout.tsx:1-19).
Các scripts phát triển chính bao gồm bun run dev cho Next.js development server trên port 3000, bun run dev:sockets cho realtime socket server, và bun run dev:full chạy cả hai đồng thời với concurrently. Script dev:full sử dụng bunx concurrently -n "App,Realtime" -c "cyan,magenta" để hiển thị logs từ cả hai processes (apps/sim/package.json:10-15).
Tính năng Nâng cao
Workflow Builder
Workflow builder cung cấp giao diện trực quan trên canvas để thiết kế agent workflows. Người dùng có thể kết nối agents, tools, và blocks thông qua drag-and-drop, sau đó chạy workflows ngay lập tức. ReactFlow được sử dụng làm foundation cho flow editor, cho phép tạo complex workflows với conditional branching và parallel execution.
Copilot AI Assistant
Copilot tận dụng AI để generate nodes, sửa lỗi, và iterate trên flows trực tiếp từ ngôn ngữ tự nhiên. Tính năng này giúp giảm thời gian phát triển workflows và hỗ trợ users không có kinh nghiệm kỹ thuật sâu. Copilot là Sim-managed service, yêu cầu API key từ sim.ai để sử dụng trên self-hosted instances.
Vector Database Integration
Nền tảng hỗ trợ upload documents vào vector store, cho phép agents trả lời câu hỏi dựa trên nội dung cụ thể. PostgreSQL với pgvector extension được sử dụng làm vector database backend, cung cấp semantic search capabilities cho knowledge retrieval.
Chỉ số Năng lực Dự án
| Chỉ số | Giá trị |
|---|---|
| Integrations được hỗ trợ | 1,000+ |
| LLM Providers | 10+ (OpenAI, Anthropic, Groq, Ollama, vLLM, etc.) |
| Database Support | 5 (PostgreSQL, MongoDB, MySQL, Neo4j, Redis) |
| Runtime Options | 3 (Cloud, NPM, Docker) |
| Local Model Support | 2 (Ollama, vLLM) |
| License | Apache 2.0 |
Lộ trình Đọc Báo cáo
正在加载图表渲染器...
Sơ đồ trên đề xuất lộ trình đọc báo cáo kỹ thuật về Sim AI Platform. Bắt đầu từ trang tổng quan hiện tại, readers có thể đi sâu vào kiến trúc hệ thống, tính năng, hoặc hướng dẫn triển khai tùy theo mục đích. Các chủ đề chuyên sâu như luồng dữ liệu, thiết kế API, và integrations nên được đọc sau khi đã nắm kiến thức cơ bản. Hướng dẫn phát triển tổng hợp các kiến thức từ tất cả các sections trước đó.