README
¶
AutoKitteh is a developer platform for workflow automation and orchestration. It is an easy-to-use, code-based alternative to no/low-code platforms (such as Zapier, Workato, Make.com, n8n) with unlimited flexibility.
You write in vanilla Python, we make it durable 🪄
In addition, it is a durable execution platform for long-running and reliable workflows. It is based on Temporal, hiding many of its infrastructure and coding complexities.
AutoKitteh can be self-hosted, and has a cloud offering as well.
Once installed, AutoKitteh is a scalable "serverless" platform (with batteries included) for DevOps, FinOps, MLOps, SOAR, productivity tasks, critical backend business processes, and more.
Try our Cloud!
Explore example automations at kittehub.
Join our community:
High-Level Architecture
Platform: A scalable server that provides interfaces for building projects (workflows), deploying them, triggering the code with webhooks or schedulers, executing the code as durable workflows, and managing these workflows.
API: AutoKitteh is an API-first platform. All services are available via gRPC / HTTP.
Built-in integrations: Slack, GitHub, Twilio, ChatGPT, Gemini, Gmail, Google Calendar, HTTP, gRPC and many more. It's easy to add new integrations.
Supported programming languages: Python, Starlark (a dialect of Python), and JavaScript (coming soon).
Discover how it works (in detail).
User Interfaces
-
Command Line Interface
-
Visual Studio Code Extension - Build and manage workflows
-
Web UI
Why You Should Give AutoKitteh a Test Drive
AutoKitteh provides a full set of advanced engineering features out-of-the-box. You can focus on writing the business logic, we take care of the rest:
- Secure, seamless, bidirectional API integrations
- User-friendly management, monitoring, and debugging
- Standalone and distributed system reliability
- Automated recovery without state loss
- Built-in durability for long-running workflows
- Readiness for world-class scalability needs
Getting Started
See our quickstart guide, which covers:
- Installation
- Starting a self-hosted server
- Creating and deploying a project
- Resilience demo
The open-source AutoKitteh server is used mostly for self-hosted and on-prem installations.
Our managed cloud iPaaS offering is currently in beta - for details, contact us at [email protected].
Build From Source
The following requires Go version 1.24 or greater.
$ git clone https://github.com/autokitteh/autokitteh.git
$ cd autokitteh
$ make ak
$ cp ./bin/ak /usr/local/bin
$ ak version
Build Requirements (Full Builds Only)
- buf
- docker
- go >= 1.24
- golangci-lint (auto-downloaded during builds if missing)
- shellcheck (auto-pulled via docker during builds if missing)
Recommended Dev Tools
- gofumpt
- gotestsum (used by Makefile instead of "go test" if detected)
- jq (for advanced output formatting)
- atlasgo (for new DB migrations)
- nodejs >= 20 (only if updating the UI)
- opa >= 0.70.0 (for checking opa policies)
Contact Us
Directories
¶
| Path | Synopsis |
|---|---|
|
backend
|
|
|
cmd
|
|
|
ak
command
AK is the autokitteh command-line interface and local server.
|
AK is the autokitteh command-line interface and local server. |
|
configs
|
|
|
common
Package common provides common utilities for integrations.
|
Package common provides common utilities for integrations. |
|
internal/extrazap
Package extrazap provides helper functions for initializing Zap loggers, as well as associating and extracting them with/from context objects.
|
Package extrazap provides helper functions for initializing Zap loggers, as well as associating and extracting them with/from context objects. |
|
microsoft/connection
Package connection implements status and test checks that are reusable across all Microsoft integrations.
|
Package connection implements status and test checks that are reusable across all Microsoft integrations. |
|
slack/api/chat
Package chat is a lightweight wrapper over the "chat" methods in Slack's Web API: https://api.slack.com/methods?filter=chat.
|
Package chat is a lightweight wrapper over the "chat" methods in Slack's Web API: https://api.slack.com/methods?filter=chat. |
|
slack/api/conversations
Package conversations is a lightweight wrapper over the "conversations" methods in Slack's Web API: https://api.slack.com/methods?filter=conversations.
|
Package conversations is a lightweight wrapper over the "conversations" methods in Slack's Web API: https://api.slack.com/methods?filter=conversations. |
|
slack/api/users
Package users is a lightweight wrapper over the "users" methods in Slack's Web API: https://api.slack.com/methods?filter=users.
|
Package users is a lightweight wrapper over the "users" methods in Slack's Web API: https://api.slack.com/methods?filter=users. |
|
slack/events
Package events implements handlers for Slack's Events API: see https://api.slack.com/apis/connections/events-api and https://api.slack.com/events?ref=apis&filter=Events.
|
Package events implements handlers for Slack's Events API: see https://api.slack.com/apis/connections/events-api and https://api.slack.com/events?ref=apis&filter=Events. |
|
internal
|
|
|
backend/cron
Package cron is a Temporal worker that implements recurring internal maintenance tasks (e.g.
|
Package cron is a Temporal worker that implements recurring internal maintenance tasks (e.g. |
|
backend/gormkitteh
TODO: Make public?
|
TODO: Make public? |
|
backend/policy/opapolicy
This is an adaptation of https://github.com/open-policy-agent/contrib/blob/main/logging/plugins/ozap/zap.go.
|
This is an adaptation of https://github.com/open-policy-agent/contrib/blob/main/logging/plugins/ozap/zap.go. |
|
kittehs
Taken from https://github.com/egtann/strip-wildcard-prefix/blob/main/strip_wildcard.go.
|
Taken from https://github.com/egtann/strip-wildcard-prefix/blob/main/strip_wildcard.go. |
|
manifest
Description of the manifest schema.
|
Description of the manifest schema. |
|
resolver
Package resolver contains functions that resolve names and ID strings of autokitteh entities to their concrete SDK types.
|
Package resolver contains functions that resolve names and ID strings of autokitteh entities to their concrete SDK types. |
|
xdg
Package XDG manages autokitteh's configuration and data directories, which are used to store optional files such as ".env", "config.yaml" (see the CLI command "ak config"), "fake_secrets_manager.json" (if you opt-out of using a real secrets manager), SaaS client credentials, etc.
|
Package XDG manages autokitteh's configuration and data directories, which are used to store optional files such as ".env", "config.yaml" (see the CLI command "ak config"), "fake_secrets_manager.json" (if you opt-out of using a real secrets manager), SaaS client credentials, etc. |
|
runtimes
|
|
|
pythonrt
gRPC server that accepts calls from the Python runner
|
gRPC server that accepts calls from the Python runner |
|
sdk
|
|
|
sdktypes
Package sdktypes contains all the data types used by the autokitteh SDK.
|
Package sdktypes contains all the data types used by the autokitteh SDK. |
|
web
|
|