Reference
Service Architect Documentation
What Service Architect is and how an executable architecture becomes generated services.
Start with a working service
Follow a practical guide, inspect the generated code, then use the reference to customize your architecture.
Design and Generate Your First MicroserviceUse the visual microservice designer to connect an HTTP endpoint to typed business logic, generate a native project and run it locally.Regenerate Services Without Losing Business CodePreview changes to a generated service, preserve user-owned functions and verify that existing business implementations still satisfy the new graph contracts.An HTTP, gRPC and Kafka Microservice ExampleFollow an order from an HTTP source through parallel Inventory RPCs to a response and a Kafka event, with explicit service boundaries and typed correlation.Trace Generated Microservices with OpenTelemetryConnect a request to its service graph, distributed trace and Grafana metrics in a generated development environment.
Browse the documentation
Stream typesOne article for every stream operator implemented by the designer and ServiceLib.Data connectorsEach connector and its endpoint contract, nested exactly by transport.Links and deliveryDirected edges and every supported call semantics mode.Type systemData contracts referenced by valueType and keyType.Practical guidesBuild, generate, run and observe microservices with visual service graphs, native code and reproducible examples.Graph DesignerHow to build, connect, read, and troubleshoot the executable service graph.Python DSLAuthor Service Architect topologies with typed Python, edit them in Designer, export canonical YAML, and generate runtime projects.Scheduling & TemporalLocal Cron triggers, durable Temporal Activities and Workflows, schedules, runtime contracts, and generated operations.Codex & MCPUse Codex and MCP for AI-assisted service design through a typed, validated architecture API instead of editing topology YAML by guesswork.Code GenerationEverything ServiceGen materializes from a graph: source trees, contracts, commands, containers and Kubernetes deployment assets.FrameworkBusiness extension APIs exposed by generated services in every supported language runtime.Service LifecycleMakers, runtime construction, endpoint admission, graph draining, graceful shutdown, and target-specific hooks.DashboardsGenerated Grafana dashboards for services, streams, connectors, transports, runtimes, and deployment environments.