Metadata-Version: 2.4
Name: nikame
Version: 0.7.4
Summary: NIKAME: High-fidelity AI & Cloud Infrastructure Scaffolding Framework (Matrix Engine)
Project-URL: Homepage, https://github.com/nikame-dev/nikame
Project-URL: Repository, https://github.com/nikame-dev/nikame
Project-URL: Issues, https://github.com/nikame-dev/nikame/issues
Author: omdeepb69
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: ai,automation,devops,docker,fastapi,infrastructure,kubernetes,llm,matrix-engine,mlops,rag,scaffolding
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.11
Requires-Dist: anyio>=4.0
Requires-Dist: click>=8.1
Requires-Dist: docker>=7.0
Requires-Dist: httpx>=0.25
Requires-Dist: jinja2>=3.1
Requires-Dist: networkx>=3.1
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: pydantic[email]>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: questionary>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: structlog>=24.0
Requires-Dist: tenacity>=8.0
Provides-Extra: all
Requires-Dist: boto3>=1.29; extra == 'all'
Requires-Dist: huggingface-hub>=0.19; extra == 'all'
Requires-Dist: kubernetes>=28.0; extra == 'all'
Requires-Dist: litellm>=1.10; extra == 'all'
Requires-Dist: requests>=2.31; extra == 'all'
Requires-Dist: streamlit>=1.30; extra == 'all'
Provides-Extra: cloud
Requires-Dist: boto3>=1.29; extra == 'cloud'
Requires-Dist: kubernetes>=28.0; extra == 'cloud'
Provides-Extra: dev
Requires-Dist: mypy>=1.7; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest-cov>=4.1; extra == 'dev'
Requires-Dist: pytest>=7.4; extra == 'dev'
Requires-Dist: ruff>=0.1; extra == 'dev'
Requires-Dist: types-docker; extra == 'dev'
Requires-Dist: types-pyyaml; extra == 'dev'
Provides-Extra: ml
Requires-Dist: huggingface-hub>=0.19; extra == 'ml'
Requires-Dist: litellm>=1.10; extra == 'ml'
Requires-Dist: requests>=2.31; extra == 'ml'
Requires-Dist: streamlit>=1.30; extra == 'ml'
Description-Content-Type: text/markdown

# NIKAME

[![CI](https://github.com/nikame-dev/nikame/actions/workflows/ci.yml/badge.svg)](https://github.com/nikame-dev/nikame/actions/workflows/ci.yml)
[![PyPI version](https://badge.fury.io/py/nikame.svg)](https://badge.fury.io/py/nikame)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Python Versions](https://img.shields.io/pypi/pyversions/nikame.svg)](https://pypi.org/project/nikame/)

**Describe your infrastructure. NIKAME builds the glue.**

NIKAME is an intelligent infrastructure framework designed for high-fidelity AI and Cloud applications. It doesn't just generate templates—it understands your stack. Powered by the **Matrix Engine**, NIKAME automatically detects module combinations and injects the complex integration logic (the "glue") required for production-grade systems.

---

## 🌟 Key Features

### 1. Matrix Engine (Intelligence Layer)
The Matrix Engine is the heart of NIKAME. It analyzes your `nikame.yaml` to detect "cross-module interactions." If you add `PostgreSQL` and `Redpanda`, it doesn't just provision them; it automatically generates a **Transactional Outbox Pattern** to guarantee event delivery.

### 2. Codegen Quality Rules Engine
Every line of code generated by NIKAME passes through a strict **Rules Engine** before reaching your disk.
- **P0 Rules**: Hard failures (e.g., broken Python imports, missing Pydantic settings).
- **P1 Rules**: Quality standards (e.g., proper retry logic for DB connections, structured JSON logging, async SQLAlchemy usage).
- **Auto-Fixing**: The engine can automatically patch common issues like missing `ResponseModel` in FastAPI.

### 3. Preflight Readiness System
Run `nikame preflight` to validate your local environment and project configuration before you even start. It checks for:
- Docker/Kubernetes connectivity.
- Cloud provider credentials (AWS/GCP).
- Module conflict detection (e.g., preventing two different API frameworks in one project).

### 4. High-Fidelity Infrastructure
- **Cloud Native**: Terraform and Helm generation for AWS/Local.
- **Security First**: Automatic NetworkPolicy, PodSecurityContext, and Secret management.
- **Observability**: Built-in Grafana dashboards, Prometheus alerts, and OpenTelemetry tracing.

---

## 🛠️ CLI Reference

| Command | Category | Description |
|:---|:---|:---|
| `nikame init` | Setup | Initialize a new project via Interactive Wizard or YAML config. |
| `nikame templates` | Registry | Discover, download, and publish project templates (`search`, `use`, `publish`). |
| `nikame up` | Ops | Start all local services via Docker Compose. |
| `nikame status` | Ops | Show real-time health and endpoints for all running services. |
| `nikame logs` | Ops | Stream and **pretty-print** JSON logs from your containers. |
| `nikame preflight` | Quality | Run production-readiness checks on your current project. |
| `nikame db` | Data | Manage Alembic migrations (`migrate`, `upgrade`, `seed`). |
| `nikame add <mod>` | Config | Add a module (e.g. `qdrant`, `redis`) to your active stack. |
| `nikame diff` | Config | Detect drift between your config and generated code. |
| `nikame regenerate` | Config | Re-run the full codegen matrix (apply manual YAML edits). |
| `nikame ml` | MLOps | Manage model versions and pull from HuggingFace. |
| `nikame github` | CI/CD | Push project secrets and configs to GitHub Actions. |
| `nikame tunnel` | Dev | Expose your local API to a public URL via Ngrok. |
| `nikame verify` | Quality | Verify that the generated code is importable and valid. |
| `nikame destroy` | Cleanup | Tear down all infrastructure and volumes. |
| `nikame templates search` | Registry | Search for community templates in the global registry. |
| `nikame templates use <id>` | Registry | Clone a template and launch the setup wizard immediately. |

---

## 🚀 Quick Start

```bash
# Install NIKAME
pip install nikame

# Start the interactive wizard
nikame init --output ./my-stack

# Verify your environment
nikame preflight --project-dir ./my-stack

# Launch the stack
cd my-stack
nikame up

# Check status
nikame status
```

---

## 🤝 Maintainer

Created and maintained by [@omdeepb69](https://github.com/omdeepb69). Built with ❤️ for the AI/Cloud community.

---

## License

Apache 2.0
