https://github.com/databrickslabs/kasal
https://github.com/databrickslabs/kasal
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/databrickslabs/kasal
- Owner: databrickslabs
- Created: 2025-05-14T09:55:53.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-02T09:25:36.000Z (10 months ago)
- Last Synced: 2025-09-02T10:30:51.264Z (10 months ago)
- Language: Python
- Size: 9.93 MB
- Stars: 43
- Watchers: 5
- Forks: 6
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-databricks-apps - KASAL - Build intelligent AI agent workflows with visual simplicity and enterprise power. (Products / Utility tools hosted on Databricks Apps)
README
Kasal
**Build intelligent AI agent workflows with visual simplicity and enterprise power.**
[](https://www.youtube.com/watch?v=0d5e5rSe5JI)
Kasal transforms complex AI orchestration into an intuitive visual experience. Design, deploy, and monitor autonomous AI agents that collaborate seamlessly to solve real-world business challenges.
## Why Kasal?
• **Visual Workflow Designer** - Drag-and-drop interface for creating sophisticated agent interactions
• **Enterprise-Ready** - Built for Databricks with OAuth, security, and scalability
• **Extensible Toolkit** - Rich library of tools including Genie, custom APIs, and data connectors
• **Real-time Monitoring** - Live execution tracking with detailed logs and performance insights
• **Production-Grade** - Robust error handling, retry logic, and enterprise deployment patterns
## What You Can Build
- **Data Analysis Pipelines** - Agents that query, analyze, and visualize your data
- **Content Generation Systems** - Collaborative agents for research, writing, and content creation
- **Business Process Automation** - Intelligent workflows that adapt and make decisions
- **Customer Support Bots** - Multi-agent systems with specialized knowledge domains
- **Research & Development** - Agents that gather, synthesize, and present insights
## Get Started in Minutes
### **Databricks Marketplace** (Recommended)
Install directly from the Databricks Apps Marketplace with one click. Perfect for production use with automatic updates and enterprise support.
### **Deploy from Source**
Use the deployment script in this codebase for custom installations and development. Ideal for customization and advanced configurations.
### **Local Development**
Quick setup for testing and development - requires Python 3.9+ and Node.js.
## See It in Action
*Visual workflow designer for creating AI agent collaborations*
Create your first agent workflow in under 2 minutes:
1. **Design** - Drag agents onto the canvas and define their roles
2. **Connect** - Link agents to create collaboration flows
3. **Execute** - Hit run and watch your agents work together
4. **Monitor** - View real-time logs and execution traces
---
## Documentation
| Topic | Description |
|-------|-------------|
| **[Why Kasal](src/docs/WHY_KASAL.md)** | What problems it solves and who it's for |
| **[Solution Architecture](src/docs/ARCHITECTURE_GUIDE.md)** | Layers, lifecycles, and platform integration |
| **[Code Structure](src/docs/CODE_STRUCTURE_GUIDE.md)** | Where things live and how to navigate the repo |
| **[Developer Guide](src/docs/DEVELOPER_GUIDE.md)** | Local setup, config, and extension patterns |
| **[API Reference](src/docs/API_REFERENCE.md)** | REST endpoints, payloads, and errors |
### More Documentation
- **[Docs Hub](src/docs/README.md)** - Documentation index
- **[End‑User Tutorial Catalog](src/docs/END_USER_TUTORIAL_CATALOG.md)** - Screenshot-ready walkthroughs
- **[Testing Guide](src/backend/tests/README.md)** - Testing strategy and coverage
---
## Architecture
Kasal uses a modern, layered architecture designed for scalability and maintainability:
**Frontend (React)** → **API (FastAPI)** → **Services** → **Repositories** → **Database**
The CrewAI Engine integrates at the service layer for intelligent agent orchestration.
## Known Limitations
### Entity Memory with Specific Models
Entity extraction in memory backends has compatibility issues with:
- **Databricks Claude** (`databricks-claude-*`) - JSON schema validation errors
- **Databricks GPT-OSS** (`databricks-gpt-oss-*`) - Empty response errors
**Automatic Fallback**: The system automatically uses `databricks-llama-4-maverick` for entity extraction when these models are detected, while keeping the original model for all other agent tasks.
## License
Licensed under the [Databricks License](src/LICENSE)
---
## Additional Resources
[Unlocking Databricks Marketplace: A Hands-On Guide for Data Consumers](https://www.databricks.com/dataaisummit/session/unlocking-databricks-marketplace-hands-guide-data-consumers)