Metadata-Version: 2.4
Name: graphruntime
Version: 2.0.0b1
Summary: Universal architecture graph extractor, merger and runtime generator — 42 languages supported
Project-URL: Homepage, https://github.com/tryboy869/graphruntime
Project-URL: Repository, https://github.com/tryboy869/graphruntime
Project-URL: Issues, https://github.com/tryboy869/graphruntime/issues
Project-URL: Registry, https://github.com/tryboy869/graphruntime/tree/main/registry
Author-email: Daouda Abdoul Anzize <anzize.contact@proton.me>
License: MIT License
        
        Copyright (c) 2026 Daouda Abdoul Anzize
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: architecture,cli,code-analysis,dependency-graph,graph,llm,merger,runtime,universal
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: click>=8.1.0
Requires-Dist: groq>=0.9.0
Requires-Dist: pathspec>=0.12.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.0.0
Requires-Dist: toml>=0.10.2
Provides-Extra: all
Requires-Dist: anthropic>=0.25.0; extra == 'all'
Requires-Dist: ollama>=0.2.0; extra == 'all'
Requires-Dist: openai>=1.0.0; extra == 'all'
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.25.0; extra == 'anthropic'
Provides-Extra: ollama
Requires-Dist: ollama>=0.2.0; extra == 'ollama'
Provides-Extra: openai
Requires-Dist: openai>=1.0.0; extra == 'openai'
Description-Content-Type: text/markdown

<!-- HEADER ANIMATION -->
<p align="center">
  <img src="assets/header.svg" alt="GraphRuntime" width="100%"/>
</p>

<!-- HOW IT WORKS ANIMATION -->
<p align="center">
  <img src="assets/how-it-works.svg" alt="How GraphRuntime Works" width="100%"/>
</p>


---


<p align="center">
  <a href="https://pypi.org/project/graphruntime/">
    <img src="https://img.shields.io/pypi/v/graphruntime?style=flat-square&color=0ea5e9&label=PyPI&logo=python&logoColor=white" alt="PyPI version"/>
  </a>
  <a href="https://pypi.org/project/graphruntime/">
    <img src="https://img.shields.io/pypi/dm/graphruntime?style=flat-square&color=8b5cf6&label=downloads%2Fmonth&logo=pypi&logoColor=white" alt="Downloads"/>
  </a>
  <a href="https://pypi.org/project/graphruntime/">
    <img src="https://img.shields.io/pypi/pyversions/graphruntime?style=flat-square&color=10b981&logo=python&logoColor=white" alt="Python versions"/>
  </a>
  <a href="https://github.com/tryboy869/graphruntime/blob/main/LICENSE">
    <img src="https://img.shields.io/github/license/tryboy869/graphruntime?style=flat-square&color=f59e0b" alt="License"/>
  </a>
  <a href="https://github.com/tryboy869/graphruntime/stargazers">
    <img src="https://img.shields.io/github/stars/tryboy869/graphruntime?style=flat-square&color=facc15&logo=github" alt="Stars"/>
  </a>
  <a href="https://github.com/tryboy869/graphruntime/actions">
    <img src="https://img.shields.io/github/actions/workflow/status/tryboy869/graphruntime/ci.yml?branch=main&style=flat-square&label=CI&logo=github-actions&logoColor=white" alt="CI"/>
  </a>
  <img src="https://img.shields.io/badge/languages-42-f59e0b?style=flat-square&logo=code&logoColor=white" alt="42 languages"/>
  <a href="https://github.com/tryboy869/graphruntime/issues">
    <img src="https://img.shields.io/github/issues/tryboy869/graphruntime?style=flat-square&color=ef4444&logo=github" alt="Issues"/>
  </a>
</p>

---

## What is GraphRuntime?

**GraphRuntime** extracts the architectural graph of any software project or package, enables LLMs to reason on that graph, and generates a `runtime.json` that connects, modifies, or fuses multiple systems — in any language.

```bash
pip install graphruntime
```

---

## The 4 Universal Questions

Every file in every project answers 4 questions:

```
→ What enters this file?      (imports, dependencies)
→ What exits this file?       (classes, functions, exports)
→ What does it call?          (internal dependencies)
→ Who calls it?               (inferred by graph inversion)
```

These 4 questions work on Python, TypeScript, Rust, Go, Java, C++, Terraform, SQL, GraphQL — **42 languages supported.**

---

## Quick Start

```bash
# Extract graph from a local repo
graphruntime extract ./my-project

# Pull a pre-analyzed graph from the registry
graphruntime pull flask
graphruntime pull numpy

# Inspect an architecture
graphruntime inspect graph.json

# Merge two architectures with an objective
graphruntime merge graph_flask.json graph_numpy.json \
  --objective "REST API that processes dataframes"

# Execute a runtime
graphruntime run runtime.json

# Let the AI choose everything
graphruntime goal "I want an API that transcribes audio files to PDF"
```

---

## CLI Commands

| Command | Description |
|---|---|
| `extract <source>` | Extract graph from local path, GitHub, PyPI, npm, cargo |
| `pull <package>` | Pull pre-analyzed graph from registry |
| `inspect <graph>` | Human-readable architecture summary |
| `diff <graph_a> <graph_b>` | Architectural diff between two versions |
| `modify <repo>` | Modify existing repo guided by graph |
| `create <repo>` | Create missing files identified by graph |
| `rewire <repo>` | Invert or reroute data flow between modules |
| `merge <a> <b>` | Fuse two architectures into a runtime |
| `run <runtime>` | Execute a runtime.json |
| `watch <repo>` | Live graph rebuild on file changes |
| `explain <graph>` | LLM explains the architecture |
| `validate <repo>` | Validate architectural integrity |
| `goal "<objective>"` | AI selects libs, builds and runs everything |
| `publish <graph>` | Contribute a graph to the registry |

---

## Supported Sources

```bash
graphruntime extract ./local-path
graphruntime extract github:user/repo
graphruntime extract pip:flask
graphruntime extract npm:react
graphruntime extract cargo:tokio
graphruntime extract go:gin-gonic/gin
```

---

## LLM Providers

```bash
graphruntime config set provider groq      # default
graphruntime config set provider openai
graphruntime config set provider anthropic
graphruntime config set provider ollama    # local
```

---

## Registry

The GraphRuntime Registry contains pre-analyzed `graph.json` files for the most critical packages in the world. Browse at `registry/` or pull directly:

```bash
graphruntime pull pandas
graphruntime pull kubernetes
graphruntime pull react
```

Contribute a new graph:
```bash
graphruntime publish my_graph.json --package mypackage --version 1.0.0
```

---

## SKILL.md for AI Agents

Any LLM or AI agent can understand and pilot GraphRuntime by reading [`SKILL.md`](SKILL.md).

---

## Contributors

<p align="center">
  <img src="assets/contributors.svg" alt="Contributors" width="100%"/>
</p>

---

## License

MIT © GraphRuntime Contributors

<p align="center">
  <img src="assets/footer.svg" alt="Footer" width="100%"/>
</p>
