tutorial
Jul 26, 2026
Getting Started with NAEOS — From Spec to Code in 5 Minutes
A hands-on tutorial showing how to declare a microservices project with NAEOS and generate Go + TypeScript code in under …
v2.1.1
Open Source
Apache 2.0
Specify Once.
Generate Everything.
From a single YAML spec, NAEOS generates complete projects — code, CI/CD, docs, deployment manifests, and AI context — across 5 languages and 6 AI platforms. Stop scaffolding. Start shipping.
terminal — naeos
$ naeos init
✓ Config initialized: naeos.yaml
$ cat spec.yaml
project: my-app
modules:
- name: api
path: ./api
generation:
languages: [go, typescript]
$ naeos run --input spec.yaml
✓ Parsed → Normalized → Resolved
✓ NEIR built | 4 modules, 8 services
✓ Generated: go/, typescript/
✓ Done in 1.2s
Your Blueprint, Automated
NAEOS is an engineering runtime that reads your YAML/JSON specification, builds a complete internal model of your system (NEIR), then orchestrates the entire engineering lifecycle — parse, validate, generate, compile, and export. Your spec stays the single source of truth from first prototype to production.
One `naeos run` produces: production-grade code in Go, TypeScript, Python, Java, or Rust; Dockerfiles and Kubernetes manifests; CI/CD pipeline configs; API documentation; and AI instruction bundles for Copilot, Claude, Cursor, Gemini, Codex, and OpenCode.
Read the DocsCLI Commands+
Languages
AI Platforms
Specifications
Core Features
35+ CLI commands · 5 languages · 6 AI platforms · 56+ specifications — one unified engineering system.
Pipeline Engine
9-stage DAG pipeline from spec to shipped code. Each stage is observable, cacheable, and extensible via plugins. Inspect every transformation from YAML to artifact.
AI Compiler
Feed your architecture directly into coding assistants. AI context bundles give Copilot, Claude, Cursor, Gemini, Codex, and OpenCode full system awareness — no more repeated prompting.
Code Generator
Production-ready code in Go, TypeScript, Python, Java, and Rust. Per-language adapters generate idiomatic project structures, tests, and dependency files out of the box.
NEIR Model
A canonical model of your entire system — project structure, architecture, modules, services, APIs, infrastructure, and security policies. NEIR is the bridge between your intent and every generated artifact.
Governance & Policy
Enforce architecture rules before they hit production. Policy engine with 7 operators, RBAC, full audit trails, and artifact review. Catch violations during generation, not deployment.
Marketplace
Publish, discover, and install industry profiles and plugins. 5 built-in profiles (SaaS, AI Agent, FinTech, Healthcare, Government) plus a growing community registry.
Quick Start
From idea to generated project in under 60 seconds.
1
Install NAEOS
Install with Go, use Docker, or download a ready-to-run binary.
bash
go install github.com/NAEOS-foundation/naeos/cmd/naeos@latest2
Create a Specification
Describe your project structure in YAML or JSON.
yaml
project: my-app
modules:
- name: auth
path: ./auth
- name: api
path: ./api
dependencies: [auth]
services:
- name: gateway
kind: http
port: 8080
generation:
languages: [go, typescript]3
Run the Pipeline
Parse, validate, generate, and export the complete project.
bash
naeos run --input spec.yaml --output-dir ./out4
Compile AI Context
Generate instruction sets for Copilot, Claude, Cursor, and other coding assistants.
bash
naeos compile --all --input spec.yamlLatest from the Blog
News, tutorials, and deep dives from the NAEOS team.
tutorial
Jul 25, 2026
Governance & Compliance in NAEOS: Built-In Policy, Audit, and SSO
How NAEOS helps teams enforce policies, maintain audit trails, and meet SOC 2, HIPAA, and GDPR requirements out of the …
release
Jul 25, 2026
NAEOS v2.2.0 Release
NAEOS v2.2.0 is now available with Supabase integration, multi-tenant workspaces, schema registry API, and more.
Backed by the Community
—
GitHub Stars
—
Forks
—
Open Issues
—
Contributors
Use Cases
From solo devs to platform teams — NAEOS adapts to how you build.
Microservices Architecture
Define your entire service mesh in one spec. Generate Go and TypeScript services with REST endpoints, Dockerfiles, and production-grade Kubernetes manifests — all from a single YAML.
Go · TypeScriptServerless Applications
Describe event sources and function chains. Generate deployable Python and TypeScript handlers with IAM policies, event mappings, and framework configuration included.
Python · TypeScriptAI-Native Development
Compile your architecture into AI instruction sets. Your coding assistants start with full context — module structure, dependencies, API contracts — without copying READMEs into every prompt.
6 AI PlatformsEnterprise Governance
Prevent architecture drift across teams. RBAC, audit trails, and a policy engine with 7 operators catch violations during generation — not after deployment.
GovernanceTry It Live
Edit a specification and inspect the resulting NEIR model structure immediately.
NEIR Model Preview
Edit the specification on the left to update this preview.
Loved by Engineers
Hear from teams that ship with NAEOS every day.
We replaced three code generators and a wiki with one NAEOS spec. Scaffolding a new Go + TypeScript service now takes seconds instead of hours.
The AI context bundles are a game changer. Claude Code understands our full architecture without me pasting README excerpts into every single prompt.
We migrated 12 services to NAEOS. The governance engine flagged three architecture violations during generation — caught them before they ever hit a PR.
Supported Languages
5 languages + 6 AI platforms — one unified engineering system.
Languages
Go
TypeScript
Python
Java
Rust
AI Platforms
GitHub Copilot
Claude Code
Cursor
Gemini CLI
Codex
OpenCode
Stop Scaffolding. Start Shipping.
Install NAEOS in one command and generate your first project in under a minute.
Install Now