Features

Humus provides four distinct service types, each optimized for different use cases.

Service Types

REST/HTTP Services

Build OpenAPI-compliant HTTP APIs with automatic schema generation and type-safe handlers.

Best For:

• Web APIs and microservices
• Public-facing services
• Services requiring OpenAPI documentation

Key Features:

• Automatic OpenAPI 3.0 generation
• Built-in health endpoints
• Type-safe request/response handling
• Path parameter and query validation

Get Started with REST →

gRPC Services

Create high-performance gRPC microservices with automatic instrumentation and health checks.

Best For:

• Internal microservices
• High-performance service-to-service communication
• Services with strongly-typed contracts

Key Features:

• Automatic gRPC health service
• Built-in interceptors for OTel
• Service registration
• Protocol Buffers support

Get Started with gRPC →

Job Services

Build one-off job executors for batch processing, migrations, and scheduled tasks.

Best For:

• Database migrations
• Batch processing
• Scheduled tasks (with external scheduler)
• One-time operations

Key Features:

• Simple Handler interface
• Full observability support
• Same lifecycle management as long-running services
• Context-aware execution

Get Started with Jobs →

Queue Services

Process messages from message queues with flexible delivery semantics and automatic concurrency management.

Best For:

• Event-driven architectures
• Message queue processing (Kafka, RabbitMQ, etc.)
• Asynchronous workloads
• Stream processing

Key Features:

• At-most-once and at-least-once delivery semantics
• Pluggable queue runtimes
• Automatic concurrency management (Kafka: goroutine-per-partition)
• Built-in OpenTelemetry instrumentation

Get Started with Queues →

Common Features

All service types include:

• OpenTelemetry Integration - Automatic traces, metrics, and logs
• Graceful Shutdown - Clean shutdown on SIGTERM/SIGINT
• Configuration Management - YAML with template support
• Panic Recovery - Automatic panic recovery in handlers
• Lifecycle Management - Managed by Bedrock framework