Metadata-Version: 2.4
Name: llmcc
Version: 0.2.50
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: pytest>=7.0 ; extra == 'dev'
Requires-Dist: pytest-cov>=4.0 ; extra == 'dev'
Requires-Dist: black>=23.0 ; extra == 'dev'
Requires-Dist: ruff>=0.1.0 ; extra == 'dev'
Requires-Dist: mypy>=1.0,!=1.18.* ; extra == 'dev'
Requires-Dist: maturin>=1.5,<2.0 ; extra == 'dev'
Provides-Extra: dev
License-File: LICENSE
Summary: LLM Context Compiler - Universal context builder for any language and document type
Keywords: llm,compiler,context,code-analysis,rust
Home-Page: https://github.com/allenanswerzq/llmcc
Author: llmcc contributors
License: Apache-2.0
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/allenanswerzq/llmcc
Project-URL: Documentation, https://github.com/allenanswerzq/llmcc#readme
Project-URL: Repository, https://github.com/allenanswerzq/llmcc.git
Project-URL: Issues, https://github.com/allenanswerzq/llmcc/issues

# llmcc

*"Prompts are the modern assembly language, models are the modern CPU."*

llmcc is a universal context builder for any language, any document.

## abstract

llmcc explores automated context generation through symbolic graph analysis. bridging the semantic gap between human-written code/documents and AI model understanding, using modern compiler design principles.

## design

![design](doc/design.svg)

## examples

Install with: ```cargo install llmcc```

```llmcc --dir codex/codex-rs --lang rust --design-graph --pagerank --top-k 100```

**codex**: [graph](https://edotor.net/?engine=dot?engine=dot#deflate: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)



```llmcc --dir kimi-cli --lang python --design-graph --pagerank --top-k 80```

**kimi-cli**: [graph](https://edotor.net/?engine=dot?engine=dot#deflate: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)


```llmcc --design-graph --pagerank --top-k 100 --lang python --dir scikit-learn```

**scikit-learn**: [graph](https://edotor.net/?engine=dot?engine=dot#deflate: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)



```llmcc --design-graph --pagerank --top-k 100 --lang rust --dir ripgrep```

**ripgrep**: [graph](https://edotor.net/?engine=dot?engine=dot#deflate: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)


```llmcc --design-graph --pagerank --top-k 100 --lang rust --dir tokio```

**tokio**: [graph](https://edotor.net/?engine=dot?engine=dot#deflate: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)


## run

```bash
llmcc [OPTIONS] < --file <FILE>...|--dir <DIR>... >
```

**Input** (required, one of):
- `-f, --file <FILE>...` — Individual files to compile (repeatable)
- `-d, --dir <DIR>...` — Directories to scan recursively (repeatable)

**Language** (optional):
- `--lang <LANG>` — Language: 'rust' or 'python' [default: rust]

**Analysis** (optional):
- `--design-graph` — Generate high-level design graph
- `--pagerank --top-k <K>` — Rank by importance (PageRank) and limit to top K
- `--query <NAME>` — Symbol/function to analyze
- `--depends` — Show what the symbol depends on
- `--dependents` — Show what depends on the symbol
- `--recursive` — Include transitive dependencies (vs. direct only)

**Output format** (optional):
- `--summary` — Show file paths and line ranges (vs. full code texts)
- `--print-ir` — Internal: print intermediate representation
- `--print-block` — Internal: print basic block graph

**Examples:**
```bash
# Design graph with PageRank ranking
llmcc --dir crates --lang rust --design-graph --pagerank --top-k 100

# Dependencies and dependents of a symbol
llmcc --dir crates --lang rust --query CompileCtxt --depends
llmcc --dir crates --lang rust --query CompileCtxt --dependents --recursive

# Cross-directory analysis
llmcc --dir crates/llmcc-core/src --dir crates/llmcc-rust/src --lang rust --design-graph --pagerank --top-k 25

# Multiple files
llmcc --file crates/llmcc/src/main.rs --file crates/llmcc/src/lib.rs --lang rust --query run_main
```

## python

Install the published package from PyPI:

```bash
pip install llmcc
```

With the package available, invoke the API directly:

```python
import llmcc

help(llmcc.run)

output = llmcc.run(
	dirs=["crates/llmcc-core/src"],
	lang="rust",
	query="CompileCtxt",
	depends=True,
	summary=True,
)
print(output)
```

