codeui-python 🌐⚡
codeui-python (codeui) is an open-source static analysis engine that converts any Python or polyglot software repository into a rich, interactive web graph visualizer, call-hierarchy tracer, defect detector, live code editor, and AI agent context builder.
It safely parses codebases via AST (Abstract Syntax Tree) without ever executing or importing target code, producing a universal intermediate representation (IR) graph.
📦 PyPI Package: https://pypi.org/project/codeui-python/
🐙 GitHub Repository: https://github.com/AAlsubari/codeUI
🌟 Main Features
1. 🕸️ Convert Any Project into an Interactive Graph
Effortlessly explore your entire codebase as a force-directed, interactive visual dependency graph:
- Universal AST Parsing: Maps modules, classes, functions, variables, imports, and calls across Python, TypeScript, Go, Rust, Java, .etc.
- Multi-Window Subgraph Workspaces: Open symbols, modules, and call chains in floating, draggable windows.
- Cross-Usage Navigation: Trace incoming/outgoing references across files in real time.
2. 📝 Interactive Code Editor & Live Edits
Edit and refactor code directly inside the graph UI (http://127.0.0.1:3000):
- Direct Disk Writing: Save edits directly to your local source files on disk with a single click.
- In-Memory Shadow Overrides: Test edits non-destructively in an in-memory shadow store with instant diff inspection before writing to disk.
3. 🔍 Static Defect Detection Engine
Includes 8 built-in static defect analyzers that identify structural code bugs before runtime:
undefined: Missing or undefined symbols and functions.dead_code: Unreferenced private functions and unused module exports.unresolved_import: Broken or unresolvable import statements.circular: Cyclic dependency chains via Tarjan's Strongly Connected Components algorithm.duplicates: Structural code clones and duplicate routines.unreachable: Code paths following terminal control statements (return,raise,exit).shadowing: Variable shadowing across nested lexical scopes.api_drift: Public API signature changes and breaking contract drift against baseline snapshots.
4. 🤖 AI Agent Context Engine
- Smart Subgraph Bundling: Extracts minimal, context-complete subgraphs for LLMs (Claude, GPT-4, Gemini) without token bloat.
⚠️ Initial Release Notice & Call for Contributions
Note on Version 0.1.1:
codeui-pythonis currently in an initial pre-release version. Static analysis across complex, dynamic multi-language codebases is intricate, and you may encounter bugs, unparsed syntax edge cases, or unsupported language features.🚀 We Welcome All Contributions!
We actively invite developers, researchers, and open-source contributors to trycodeui-python, report issues, submit feature requests, or open pull requests to help expand language support and parser capabilities.
📦 Installation
Install the library via PyPI:
pip install codeui-python
Or install the development version from source:
git clone https://github.com/AAlsubari/codeUI.git
cd codeUI
pip install -e ".[dev]"
🚀 Quickstart
1. Launch Interactive Graph Visualizer
Run codeui serve in any repository directory to open the interactive browser graph:
codeui serve . --port 3000
Then open http://127.0.0.1:3000 in your browser to interactively explore, search, trace, and edit your code.
2. Command Line Interface (CLI)
# Scan a codebase into a JSON graph representation
codeui scan .
# Trace forward execution dependencies for a symbol
codeui trace "src/main.py::run" . --direction forward --depth 3
# Generate minimal LLM Context Bundle for AI agents
codeui context . --symbol "src/main.py::run"
# Scan codebase for defects (SARIF format)
codeui defects . --format sarif
3. Python API Usage
from pathlib import Path
from codeui.cli.main import scan_project
from codeui.tracer.tracer import Tracer
from codeui.agent.context import ContextBuilder
# 1. Scan codebase into a Universal AST Graph (No code execution)
graph = scan_project(Path("."))
# 2. Perform Call Graph Tracing
tracer = Tracer(graph)
dependencies = list(tracer.forward("src/main.py::run"))
# 3. Extract LLM Context Bundle for AI Agents
builder = ContextBuilder(graph)
bundle = builder.for_symbol("src/main.py::run", depth=2)
print(bundle.to_json())
📚 Documentation & Resources
- Quickstart Guide
- Python API Reference
- AI Agent Integration & Context Engine
- Architecture Overview
- Static Analyzer & Defect Reference
- Extending codeui
📄 License
codeui-python is distributed under the MIT License. Copyright (c) 2026 Akram Alsubari and contributors.
Metadata
Release files for codeui-python 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| codeui_python-0.1.1.tar.gz | 146.8 kB | Without provenance | Details for codeui_python-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| codeui_python-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for codeui_python-0.1.1-py3-none-any.whl |
Total release size: 320.4 kB
Release files / codeui_python-0.1.1.tar.gz
| Download URL | codeui_python-0.1.1.tar.gz |
|---|---|
| Size | 146.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4f851f60e251882b0e885ee3019e9481eacc9aa714a12ae635b654a07a37a40e
|
|
BLAKE2b-256 checksum How to use checksums |
b3fcb2e5a1e54dd3cb3a9e89b9c75f8c6cda3da3b4b9e6aae94959c50d8d9764
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / codeui_python-0.1.1-py3-none-any.whl
| Download URL | codeui_python-0.1.1-py3-none-any.whl |
|---|---|
| Size | 173.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4376a34645f87905ea7ad3888cf623e02681049682c4547660bdbbe70c210d90
|
|
BLAKE2b-256 checksum How to use checksums |
1dcb0e6f21128ac7ebd84790ca148d4331b847fd7a1755614f3284645ef658a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for codeui-python 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.