SmythOS UI - The Visual Agent Builder

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.

🚀 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:

• Intuitive Visual Builder: Drag-and-drop components to build complex agent workflows
• Real-Time Testing: Test your agents instantly as you build them
• Production Deployment: One-click deployment from development to production
• Extensible Architecture: Add custom components and integrations
• Collaborative Development: Share and collaborate on agent projects with your team

Quick Start

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

🐳 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:

• Visual Agent Builder: Drag-and-drop interface for creating agent workflows
• React Frontend: Modern, responsive user interface
• Backend API: RESTful services for agent management and execution
• Real-Time Testing: Instant agent testing and debugging

🔧 Middleware Package - packages/middleware

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

Features:

• Database Management: Prisma-based ORM with MySQL support
• API Layer: Centralized business logic and data access

⚡ Runtime Package - packages/runtime

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

Features:

• Agent Execution: High-performance runtime for agent workflows
• Debugging Tools: Real-time debugging and monitoring
• Scalable Architecture: Handles multiple concurrent agent executions
• Embodiment Support: Deploy agents as chatbots, APIs, and integrations

Documentation

• Contributing Guide - Set up your development environment and contribute to the project
• Docker Compose Setup - Container deployment with automatic SSL, database, and caching.
• Code of Conduct - Community guidelines and standards

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:

• 🐛 Report bugs and issues
• 💡 Suggest new features and improvements
• 🔧 Submit pull requests with fixes and enhancements
• 📖 Improve documentation and examples
• 🎨 Design UI/UX improvements

Get Started:

1. Read our Contributing Guide
2. Check out open issues
3. Join our Discord community

Contributors

Community & Support

• 💬 Discord: Join our community for real-time support and discussions
• 🐛 Issues: Report bugs and request features
• 📧 Email: Contact us at [email protected] for enterprise inquiries
• 🌐 Website: Visit SmythOS.com for more information

License

This project is licensed under the MIT License.

Ready to build your first AI agent?

🚀 Get Started Now | 💬 Join our Discord | 🌟 Star this repo

---

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

Build visually. Deploy globally. Scale infinitely.