smythos-studio README

The project's README from github.com/SmythOS/smythos-studio. As one markdown file: README.md.

SmythOS UI - The Visual Agent Builder

Homepage

The complete visual interface for building, deploying, and managing intelligent AI agents. SmythOS UI provides an intuitive drag-and-drop workspace where you can create sophisticated agent workflows without writing code, while still offering the flexibility of custom integrations when needed.

If you prefer to build agents with code instead, or you want to run your visual agents on your local PC without overhead, check out SmythOS Runtime, SDK and CLI! Great community, support, tutorials. Start in minutes!

SmythOS Visual Agent Studio

🚀 Getting Started | 📖 Documentation | 🐳 Docker Setup | 🤝 Contributing

Why SmythOS Studio

  1. Visual Agent Building: Creating AI agents should be as intuitive as drawing a flowchart.
  2. No-Code to Pro-Code: Start with visual building, extend with custom code when needed.
  3. Open Architecture: Build once, deploy anywhere with complete control over your infrastructure.

Design Principles

SmythOS UI provides a complete visual development environment for AI agents. Just as modern IDEs make software development accessible, SmythOS UI makes AI agent development intuitive and powerful.

Visual-First Development

SmythOS UI offers a drag-and-drop interface for building complex agent workflows. Whether you're connecting LLMs, integrating APIs, processing data, or orchestrating multi-step workflows, everything is visual and intuitive.

This approach makes AI agent development accessible to everyone - from business analysts who understand the processes to developers who need to scale them to production.

Key Benefits:

Quick Start

SmythOS Studio Tutorial

Method 1: Docker Quick Start

Get up and running instantly with Docker Compose.

git clone https://github.com/SmythOS/smythos-studio.git
cd smythos-studio
cp .env.compose.example .env
docker compose up -d

Access your application: http://localhost:6060

🐳 Full Docker Setup: See our Docker Compose Guide for container deployment with automatic SSL, database, and caching.

Troubleshooting: If you encounter any issues during setup, check the Troubleshooting section in the Docker Compose guide.


Method 2: Local Development Setup

Perfect for development, customization, and contributing to the project.

# Clone the repository
git clone https://github.com/SmythOS/smythos-studio.git
cd smythos-studio

# Copy environment configuration
cp .env.example .env
# Edit .env with your database credentials

# Install dependencies
pnpm install

# Start development servers
pnpm dev

Next Steps:

  1. Configure your MySQL database in .env
  2. Set up required subdomains for embodiments
  3. Start building your first agent!

📖 Detailed Setup: See our Contributing Guide for complete development setup instructions.


Repository Structure

This monorepo contains the complete SmythOS UI platform:

📱 App Package - packages/app

The main application containing the visual builder, React frontend, and backend services.

Key Features:

🔧 Middleware Package - packages/middleware

Core API services and database management for the SmythOS UI platform.

Features:

⚡ Runtime Package - packages/runtime

The execution server that uses SRE Core Engine to execute the agents.

Features:

Documentation

Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help makes SmythOS UI better for everyone.

Ways to Contribute:

Get Started:

  1. Read our Contributing Guide
  2. Check out open issues

Contributors

Community & Support

License

This project is licensed under the MIT License.

Ready to build your first AI agent?

🚀 Get Started Now | 🌟 Star this repo


/smɪθ oʊ ɛs juː aɪ/

Build visually. Deploy globally. Scale infinitely.

smythos-studio (SmythOS/smythos-studio)

Searching Database…

这是什么?SmythOS Studio 是一个用于创建和部署 AI 智能体的开源可视化构建器,你通过拖放组件来组装智能体工作流,而不用从头写代码。
这是无代码工具,还是我仍然可以写自定义代码?它是一个从无代码到专业代码(no-code-to-pro-code)的工具:你从可视化拖拽构建器起步,需要更强控制时可以用自定义代码扩展工作流。
怎么让 Studio 跑起来?最快的路子是用 Docker Compose 一步到位;也可以配置 MySQL 和项目的 .env 文件,做本地开发安装。
跑它之前必须有 MySQL 数据库吗?是的,本地开发必须在 .env 文件里配置一个 MySQL 数据库;Docker Compose 部署会自动带上数据库。
除了装上它,还要额外配置什么?本地开发还需要为 embodiment(智能体以聊天机器人、API 等形式对外暴露的方式)设置好所需的子域名,之后才能完整运行。
它面向谁——业务用户还是开发者?两者都面向:可视化流程是给业务分析师和非程序员用的,开发者则可以用自定义代码扩展智能体,并把它们扩展到生产规模。
它跑在哪儿——云端、本地,还是都行?在 Studio 里构建的智能体可以部署到任何地方:本地、云端或边缘,因为它是可自托管的开源架构。
SmythOS 里的“embodiment”是什么?embodiment 指的是已部署的智能体对外暴露的方式,比如一个聊天机器人、一个 API 端点或其他集成形式,由运行时包负责处理。
什么情况下我会选 SmythOS Runtime/SDK/CLI 而不是这个 Studio?如果你更想完全用代码构建智能体,或者想在本地跑可视化智能体又不想背上 Studio 的整套界面开销,单独的 SmythOS Runtime、SDK 和 CLI 就是更轻量的代码优先路线。
SmythOS Studio 的代码是怎么组织的?它是一个 monorepo,拆成 packages/app(React 可视化构建器和后端 API)、packages/middleware(基于 Prisma 的 MySQL 数据层)和 packages/runtime(构建在 SRE Core Engine 之上的执行服务器)。
Creator
SmythOS
Size
49.6 MB
Stars
654
Updated
CommitMar 31
Age
1y
Commits · 90 Days