Welcome to Naftiko Framework, the first Open Source project for Spec-Driven Integration reinventing API integration for the AI era with governed and versatile capabilities that streamline API sprawl from massive SaaS and microservices growth.
Each capability is a coarse piece of domain that consumes existing HTTP-based APIs then exposes them in several protocols to enable AI integration and self-integrating agents. Naftiko Framework includes a specification, an engine and a CLI.
| Feature | Description |
|---|---|
| Spec-Driven Integration | Declare capabilities entirely in YAML — no Java required |
| Multi-Protocol Servers | Expose capabilities via MCP, SKILL, or REST servers out of the box |
| Control Port | Built-in management plane with health, metrics, traces, and status endpoints |
| Cloud Native | OpenTelemetry tracing & RED metrics, Prometheus scrape, ready-to-run Docker container |
| Data Format Conversion | Transform Protobuf, XML, YAML, CSV, TSV, PSV, Avro, HTML, and Markdown payloads into JSON |
| HTTP API Consumption | Connect to any HTTP-based API with built-in authentication support |
| Templating & Querying | Use Mustache templates and JSONPath expressions for flexible data mapping |
| Domain-Driven Aggregates | Define reusable domain functions once, expose via multiple adapters — inspired by DDD Aggregate pattern |
| Server Authentication | Secure exposed endpoints with Bearer, API Key, Basic, Digest, or OAuth 2.1 authentication out of the box |
| AI Native | Designed for Context Engineering and Agent Orchestration, making capabilities directly consumable by AI agents |
| OpenAPI Interoperability | Import Swagger 2.0, OAS 3.0/3.1 into consumes adapters, export REST adapters as OpenAPI documents |
| Extensible | Open-source core extensible with new protocols and adapters |
Here are additional documents to learn more:
- 🧭 Spec-Driven Integration
- 🚣 Installation
- ⛵ Tutorial - Part 1
- 🚤 Tutorial - Part 2
- 🚢 Guide - Use Cases
- 🔍 Guide - Linting
- ⚓ Specification - Schema
- 📐 Specification - Rules
- 🌊 FAQ
- 📣 Releases
- 🔭 Roadmap
- 🔩 Contribute
Naftiko Framework is part of Naftiko Fleet (Community Edition), which adds free complementary tools:
| Tool | What it does |
|---|---|
| Naftiko Extension for VS Code | Inline structure and rules validation while editing .naftiko.yaml files |
| Naftiko Templates for Backstage | Scaffold and catalog capabilities from CNCF Backstage |
| Naftiko Operator for Kubernetes | Deploy and operate capabilities on Kubernetes (coming soon) |
Please join the community of users and contributors in this GitHub Discussion forum!.
