Automagik

What's New

Features
- Added health check to source validation
- Added workflow components support
- Improved workflow task tracking
- Added API key middleware
- Prevent source removal with associated workflows

Improvements
- Standardized CLI group naming
- Optimized workflow list endpoint
- Improved workflow sync endpoint
- Improved dev setup script

Bug Fixes
- Fixed remote URL variables on env examples
- Fixed sources command to plural
- Fixed tasks data schema input/output fields
- Fixed Redis port configuration
- Fixed HttpUrl to string conversion in sources API

Other Changes
- Removed unnecessary fields on schedule creation
- Removed manual status setting from source creation
- Added status on root endpoint

Major Architectural Changes

1. Distributed Task Processing with Celery
- Implemented a robust Celery-based task processing system
- Added a custom DatabaseScheduler for reliable task scheduling
- Integrated Redis as the message broker and result backend
- Enhanced scheduler reliability with database-backed persistence
- Added worker management with foreground execution mode
- Implemented retry mechanisms and error handling for tasks

2. Multi-Source LangFlow Integration
- Added comprehensive workflow source management
- Support for multiple LangFlow instances
- New API endpoints for managing workflow sources
- Enhanced remote flows API integration
- Improved workflow synchronization across sources

3. Workflow Management
- Complete refactor from flows to workflows architecture
- Added LangFlowManager for workflow execution
- Enhanced workflow scheduling with one-time and recurring schedules
- Improved workflow input handling and validation
- Added workflow component management
- Enhanced workflow deletion with proper cleanup of related objects

Infrastructure & Performance
- Integrated Redis for improved task queue management
- Consolidated timezone configuration (AUTOMAGIK_TIMEZONE)
- Enhanced database initialization and migrations
- Improved setup process with Docker integration
- Better error handling and logging throughout the system

API Enhancements
- New endpoints for workflow source management
- Enhanced workflow management endpoints
- Improved task management and monitoring
- Better error handling for invalid component responses

CLI Improvements
- Added worker logs command for better debugging
- Enhanced schedule list command
- Improved workflow sync command with source name support
- Better task management commands
- Enhanced error reporting and user feedback

Bug Fixes
- Fixed scheduling one-time creation issues
- Improved workflow deletion functionality
- Fixed workflow sync and execution issues
- Resolved greenlet errors in workflow sync
- Fixed various task execution and scheduling issues

Code Quality & Testing
- Extensive test coverage for new features
- Improved test structure and organization
- Enhanced error handling and logging
- Better code organization and modularity
- Consolidated version management

Breaking Changes
The transition from flows to workflows architecture introduces some breaking changes:
- Workflow API endpoints have changed
- Task execution model has been updated
- Configuration structure has been modified

Migration Guide
1. Update your configurations to use the new AUTOMAGIK_TIMEZONE setting
2. Migrate your existing flows to the new workflow structure
3. Update any custom integrations to use the new API endpoints
4. Configure Redis for Celery integration

Dependencies
Added new required dependencies:
- Celery for distributed task processing
- Redis for message broker and result backend
- Additional Python packages for enhanced functionality

See `pyproject.toml` for the complete list of dependencies.

Initial release with PyPI publishing workflow

AutoMagik is a workflow automation system that lets you run AI-driven flows from LangFlow with minimal fuss. Deploy tasks, monitor them, and iterate quickly—without writing a bunch of code.

Key Features

- 🔄 **LangFlow Integration**: Seamlessly run and manage LangFlow-based AI workflows
- 🕒 **Task Scheduling**: Flexible scheduling with cron and interval-based options
- 🎯 **Task Management**: Monitor, retry, and track task execution
- 🔌 **API & CLI**: Full-featured REST API and command-line interface
- 📊 **Worker Management**: Robust worker process management with health monitoring
- 🔐 **API Key Authentication**: Secure API access with key-based authentication

Installation

bash
pip install automagik


Documentation

For detailed setup instructions and usage examples, visit our [documentation](https://github.com/namastexlabs/automagik/tree/main/docs).

Requirements

- Python 3.9+
- PostgreSQL
- Docker (optional, for containerized setup)

Changes in this Release

- Initial implementation of core workflow automation features
- Complete CLI interface for task and worker management
- REST API with OpenAPI documentation
- Database migrations and management tools
- Comprehensive test suite with 74 passing tests
- MIT License