Tiny Systems Docs

Tiny SystemsSelf-hosted AI agents on Kubernetes

Describe an agent in your editor. It runs as real workloads on your own cluster — your keys, your data.

Developer Guide

AI-Powered

Describe what you want in natural language. The MCP server builds real Kubernetes CRDs in your cluster.

Get started

Kubernetes Native

Flows run as TinyNode CRDs managed by module operators. kubectl get tinynodes — it's real Kubernetes.

Architecture

Build Custom Modules

Create your own components using the Go SDK. Define ports, handle messages, publish to the catalog.

Create a component

Open Source Modules

HTTP servers, Slack, Kubernetes ops, encoding, gRPC, and more. Install via Helm or build your own.

Browse modules

Any AI Client

Works with Claude Code, Claude Desktop, Cursor, Windsurf, or any tool that speaks the Model Context Protocol.

Setup guide

Your Infrastructure

Self-hosted on your cluster. No SaaS dependency, no vendor lock-in. Your data never leaves your infrastructure.

Requirements

Getting Started

Install the MCP server and build your first flow.

Quick Start — Install, connect, prompt
MCP Server Setup — Claude Code, Claude Desktop, Cursor
What is Tiny Systems? — Overview
Core Concepts — Nodes, flows, modules, edges

For Developers

Create custom modules and components.

Prerequisites — Setup your environment
Hello World Component — Build your first component
Component Patterns — Best practices
Publishing Modules — Deploy your modules

Reference

Complete API and configuration reference.

Kubernetes API — CRD specifications
Expression Syntax — Data transformation
Struct Tags — Schema generation
System Ports — Built-in ports

Examples

Learn from complete working examples.

Simple Transformer — Data transformation
HTTP Server — Web endpoints
Webhook to Slack — Complete flow example
API Integration — Multi-service orchestration