Open Source · MIT License

Enterprise infrastructure
on your laptop.

One command scaffolds a full-stack app with CI/CD, observability, Kafka, Postgres, Grafana, Jenkins, and an AI debugging agent. All wired together and running in Docker. No cloud required.

Install npm install -g @blissful-infra/cli
View on GitHub
zsh
$ blissful-infra start my-app --database postgres-redis

 Scaffolded project        my-app/
 Generated docker-compose  12 services
 Flyway migrations applied V1__init.sql
 Kafka topics created      events, dlq
 Registered with Jenkins   http://localhost:8081

Services running:
  Frontend   → http://localhost:3000
  Backend    → http://localhost:8080
  Grafana    → http://localhost:3001
  Dashboard  → http://localhost:3002

Everything wired in from day one

blissful-infra doesn't just orchestrate services you wrote. It creates them, fully configured and connected.

Full-stack scaffolding

Spring Boot, FastAPI, Express, or Go backend. React or Next.js frontend. Generated as real, readable code in your project directory.

Event streaming

Kafka wired to your backend out of the box. WebSocket and SSE endpoints in every template. Dead-letter queues configured automatically.

Database layer

Postgres with Flyway migrations. Redis with Spring Cache annotations. Choose postgres-redis for a cache-aside pattern from day one.

Observability

Prometheus, Grafana, and Loki pre-configured. Three dashboards provisioned automatically: Service Overview, JVM Metrics, Infrastructure.

CI/CD pipeline

A shared Jenkins instance manages every project. Jenkinsfile generated per project. Trigger builds, view stage results from the dashboard.

AI agent

Ask Claude or Ollama to diagnose production issues. The agent has access to your logs, metrics, and service health in real time.

Kubernetes-ready

Kustomize manifests, Argo CD application configs, canary rollout specs, and chaos tests generated alongside your Docker setup.

Plugins

Add an ML data platform, a Scrapy web scraper, or a LangGraph agent service with a single flag. Each plugin wires itself into Kafka automatically.

Up in under a minute

Prerequisites: Docker Desktop running, Node.js 18+

1

Install

npm install -g @blissful-infra/cli
2

Create a project

blissful-infra start my-app --backend spring-boot --database postgres-redis
3

Open the dashboard

blissful-infra dashboard
4

Add an AI/ML pipeline

blissful-infra start my-app --plugins ai-pipeline,scraper

Services started

ServiceURLPurpose
Frontendlocalhost:3000React + Vite
Backend APIlocalhost:8080Spring Boot / FastAPI / Go
Grafanalocalhost:3001Metrics dashboards
Dashboardlocalhost:3002Project management UI
Jenkinslocalhost:8081CI/CD pipelines
MLflowlocalhost:5001ML experiment tracking
ClickHouselocalhost:8123Columnar analytics

Reference examples

Fully runnable projects that demonstrate real production patterns.

ML · Kafka · ClickHouse

Content Recommender

Real-time personalized recommendations using ALS collaborative filtering. Scrapy scrapes Hacker News every 15 minutes. Articles flow Kafka to ClickHouse to model retrain. Automatic fallback to synthetic data before the first crawl.

Spring BootReactKafkaClickHouseMLflowScrapy
blissful-infra example content-recommender

Control your infra from Claude

blissful-infra ships an MCP server. Point Claude Desktop or Claude Code at it and manage your entire local platform through conversation. No context switching.

  • Create, start, and stop projects
  • Read logs and diagnose errors
  • Check service health and metrics
  • Trigger CI pipelines and deployments
  • Roll back a broken release
claude_desktop_config.json
{
  "mcpServers": {
    "blissful-infra": {
      "command": "npx",
      "args": ["-y", "@blissful-infra/cli", "mcp"]
    }
  }
}
Why is the backend in my-app restarting? Check the logs.
I'll check the logs now…

The backend is OOMKilled. Heap usage hit 512 MB. The GET /products endpoint is querying without pagination. I'd recommend adding Pageable to the repository method and setting a max page size of 100.

The full stack

Backends

  • Kotlin + Spring Boot
  • Python + FastAPI
  • Node + Express
  • Go + Chi

Frontends

  • React + Vite + Tailwind
  • Next.js + Tailwind

Data

  • Postgres + Flyway
  • Redis (Spring Cache)
  • Kafka + Zookeeper
  • ClickHouse

Observability

  • Prometheus
  • Grafana
  • Loki
  • Jaeger

CI/CD

  • Jenkins
  • Argo CD
  • Kustomize
  • Trivy security scans

ML / AI

  • MLflow
  • Mage
  • Scrapy
  • Claude + Ollama