This release is a pre-release and may not be stable for production use.
MooseStack
Developer toolkit for building real-time analytical backends in Typescript and Python — MooseStack brings data engineering best practices and a modern web development DX to any engineer building on data infra.
MooseStack modules offer a type‑safe, code‑first developer experience layer for popular open source analytical infrastructure, including ClickHouse, Kafka, Redpanda, and Temporal.
MooseStack is designed for:
- Software engineers integrating analytics & AI into their apps, and leaning into real-time / OLAP infrastructure best practices
- Data engineers building software & AI applications on their data infra, and leaning into software development best practices
Why MooseStack?
- Git-native development: Version control, collaboration, and governance built-in
- Local-first experience: Full mirror of production environment on your laptop with
moose dev - Schema & migration management: typed schemas in your application code, with transparent migration support
- Code‑first infrastructure: Declare tables, streams, workflows, and APIs in TS/Python -> MooseStack wires it all up.
- Modular design: Only enable the modules you need. Each module is independent and can be adopted incrementally.
- AI copilot friendly: Designed from the ground up for LLM-powered development
MooseStack Modules
- Moose OLAP: Manage ClickHouse tables, materialized views, and migrations in code.
- Moose Streaming: Real‑time pipelines with Kafka/Redpanda and transformation functions.
- Moose Workflows: ETL pipelines and tasks with Temporal.
- Moose APIs: Type‑safe ingestion and query endpoints with auto‑generated OpenAPI docs.
- MooseStack Tooling: Moose Deploy, Moose Migrate, Moose Observability
Quickstart
Also available in the Docs: 5-minute Quickstart
Already running Clickhouse: Getting Started with Existing Clickhouse
Install the CLI
bash -i <(curl -fsSL https://fiveonefour.com/install.sh) moose
Create a project
# typescript
moose init my-project --from-remote <YOUR_CLICKHOUSE_CONNECTION_STRING> --language typescript
# python
moose init my-project --from-remote <YOUR_CLICKHOUSE_CONNECTION_STRING> --language python
Run locally
cd my-project
moose dev
MooseStack will start ClickHouse, Redpanda, Temporal, and Redis; the CLI validates each component.
Deploy with Boreal
The easiest way to deploy your MooseStack Applications is to use Boreal from 514 Labs, the creators of Moose. Boreal provides zero-config deployments, automatic scaling, managed or BYO infrastructure, monitoring and observability integrations.
Deploy Yourself
Moose is open source and can be self-hosted. For detailed self-hosting instructions, see our deployment documentation.
Examples
TypeScript
import { Key, OlapTable, Stream, IngestApi, ConsumptionApi } from "@514labs/moose-lib";
interface DataModel {
primaryKey: Key<string>;
name: string;
}
// Create a ClickHouse table
export const clickhouseTable = new OlapTable<DataModel>("TableName");
// Create a Redpanda streaming topic
export const redpandaTopic = new Stream<DataModel>("TopicName", {
destination: clickhouseTable,
});
// Create an ingest API endpoint
export const ingestApi = new IngestApi<DataModel>("post-api-route", {
destination: redpandaTopic,
});
// Create consumption API endpoint
interface QueryParams {
limit?: number;
}
export const consumptionApi = new ConsumptionApi<QueryParams, DataModel[]>("get-api-route",
async ({limit = 10}: QueryParams, {client, sql}) => {
const result = await client.query.execute(sql`SELECT * FROM ${clickhouseTable} LIMIT ${limit}`);
return await result.json();
}
);
Python
from moose_lib import Key, OlapTable, Stream, StreamConfig, IngestApi, IngestApiConfig, ConsumptionApi
from pydantic import BaseModel
class DataModel(BaseModel):
primary_key: Key[str]
name: str
# Create a ClickHouse table
clickhouse_table = OlapTable[DataModel]("TableName")
# Create a Redpanda streaming topic
redpanda_topic = Stream[DataModel]("TopicName", StreamConfig(
destination=clickhouse_table,
))
# Create an ingest API endpoint
ingest_api = IngestApi[DataModel]("post-api-route", IngestApiConfig(
destination=redpanda_topic,
))
# Create a consumption API endpoint
class QueryParams(BaseModel):
limit: int = 10
def handler(client, params: QueryParams):
return client.query.execute("SELECT * FROM {table: Identifier} LIMIT {limit: Int32}", {
"table": clickhouse_table.name,
"limit": params.limit,
})
consumption_api = ConsumptionApi[RequestParams, DataModel]("get-api-route", query_function=handler)
5 Minute Quickstart
Already running Clickhouse? MooseStack gives you a modern software DX on your existing ClickHouse or ClickHouse Cloud cluster: Getting Started with Existing Clickhouse
Install the CLI
bash -i <(curl -fsSL https://fiveonefour.com/install.sh) moose
Create a project
# typescript
moose init my-project --from-remote <YOUR_CLICKHOUSE_CONNECTION_STRING> --language typescript
# python
moose init my-project --from-remote <YOUR_CLICKHOUSE_CONNECTION_STRING> --language python
Run locally
cd my-project
moose dev
MooseStack will start ClickHouse, Redpanda, Temporal, and Redis; the CLI validates each component.
Deploy with Boreal
The easiest way to deploy to production with MooseStack is to use Boreal from Fiveonefour, the creators of MooseStack. Boreal provides github integration for CI/CD and one click deploys, cloud previews of your dev branches, managed or BYO infrastructure, and security + observability. Boreal works natively with ClickHouse Cloud and RedPanda Cloud.
Deploy Yourself
MooseStack is open source, and apps built with MooseStack can be self-hosted. For detailed self-hosting instructions, see our deployment documentation.
Docs
Built on
- ClickHouse (OLAP storage)
- Redpanda (streaming)
- Temporal (workflow orchestration)
- Redis (internal state)
Community
Cursor Background Agents
MooseStack works with Cursor's background agents for remote development. The repository includes a pre-configured Docker-in-Docker setup that enables Moose's Docker dependencies to run in the agent environment.
Quick Setup
- Enable background agents in Cursor
- The environment will automatically build with Docker support
- Run
moose devor other Moose commands in the agent
For detailed setup instructions and troubleshooting, see Docker Setup Documentation.
Contributing
We welcome contributions! See the contribution guidelines.
License
MooseStack is open source software and MIT licensed.
3 maintainers
Metadata
3 maintainers
Release files for moose-cli 0.6.148.dev3783597845
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| moose_cli-0.6.148.dev3783597845-py3-none-manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.28+ x86-64 | Details |
| moose_cli-0.6.148.dev3783597845-py3-none-manylinux_2_28_aarch64.whl | Python 3 | none | Linux glibc 2.28+ ARM64 | Details |
| moose_cli-0.6.148.dev3783597845-py3-none-macosx_14_0_arm64.whl | Python 3 | none | macOS 14.0+ ARM64 | Details |
| moose_cli-0.6.148.dev3783597845-py3-none-macosx_13_0_x86_64.whl | Python 3 | none | macOS 13.0+ x86-64 | Details |
Total release size: 55.3 MB
Release files / moose_cli-0.6.148.dev3783597845-py3-none-manylinux_2_28_x86_64.whl
| Download URL | moose_cli-0.6.148.dev3783597845-py3-none-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 14.6 MB |
| Tags | Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
56095b3aeb90d8d36f3659c4da7034136b8f5603dbdb975fc4dcfed8ea9aa699
|
|
BLAKE2b-256 checksum How to use checksums |
ff00fda3feafeecd979df1c86cc16e2a97eb493b95426cae17d3ade8c885f95a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.9.6
|
Release files / moose_cli-0.6.148.dev3783597845-py3-none-manylinux_2_28_aarch64.whl
| Download URL | moose_cli-0.6.148.dev3783597845-py3-none-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 13.9 MB |
| Tags | Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
99d9dd79ec7e9bda2d6dac9276d094825800ed152f2004f8abf2cb7d78a8ac24
|
|
BLAKE2b-256 checksum How to use checksums |
47f140a1a459c1779cbc9f0f9b0a54e74e27c5d57201cb61058986d6c9821e47
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.9.6
|
Release files / moose_cli-0.6.148.dev3783597845-py3-none-macosx_14_0_arm64.whl
| Download URL | moose_cli-0.6.148.dev3783597845-py3-none-macosx_14_0_arm64.whl |
|---|---|
| Size | 13.1 MB |
| Tags | Python 3 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
bfff27c0e8fb66807dbdd7c368523770e06ccb5c4887c707359a3dd5105e428a
|
|
BLAKE2b-256 checksum How to use checksums |
b195bae9c0f444b41c4c7ac844a7d295ac2a38679f8aa7dae179923c7bfc0973
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.9.6
|
Release files / moose_cli-0.6.148.dev3783597845-py3-none-macosx_13_0_x86_64.whl
| Download URL | moose_cli-0.6.148.dev3783597845-py3-none-macosx_13_0_x86_64.whl |
|---|---|
| Size | 13.8 MB |
| Tags | Python 3 macOS 13.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
eebedf1a6cc34e92bf14e22b1b207c77e797448348696b523f658b8a1379b477
|
|
BLAKE2b-256 checksum How to use checksums |
8d3fd5eb056f5bc4fdf8f5e054b16941fd2a20b35a23169920568452af6979de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.9.6
|
