Skip to main content

codeui-python 🌐⚡

PyPI Version Python Version License: MIT Code Style

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-python is 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 try codeui-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


📄 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)

Source distribution for codeui-python 0.1.1
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)

Table of built distributions (wheels) for codeui-python 0.1.1
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page