Unified Visual Architecture • JSON-based OOP Model • AI‑Readable System
Atila Ghashghaie
Designer of Machinery & Electronic Circuits • Software Architecture Researcher
Email: atila.gh@gmail.com
Website: http://O2prex.ir
License: Proprietary Commercial (NOT Open Source)
O²Prex is NOT just another IDE.
It's a Visual Architecture Management Layer that sits ABOVE traditional IDEs like VS Code, PyCharm, or IntelliJ. Think of it as the Control Panel for your entire project architecture.
┌─────────────────────────────────────────────────────────────────────┐
│ │
│ THE ARCHITECTURE LAYER │
│ │
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ O²Prex │ │
│ │ Visual Architecture Management, Analysis, & Control │ │
│ │ │ │
│ │ • Visual OOP Structure Display │ │
│ │ • Live Search & Isolation │ │
│ │ • Dependency Analysis (Datum Connections) │ │
│ │ • Variable Inspector │ │
│ │ • Todo & Flag Management │ │
│ │ • Lock/Suppress Controls │ │
│ │ • AI-Ready Export (JSONC) │ │
│ │ • Architecture-as-a-File │ │
│ │ • Merge Engine for Code Generation │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────┬────────────────────┬────────────────┐ │
│ │ VS Code │ PyCharm │ IntelliJ │ │
│ │ The Code Layer │ The Code Layer │ The Code Layer│ │
│ │ Write & Debug Code │ Write & Debug Code│ Write & Debug │ │
│ └──────────────────────┴────────────────────┴────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────┘
Traditional IDEs = Tools for writing, debugging, and running code
O²Prex = Tool for architecture, navigation, analysis, and project control
They don't compete - they COMPLEMENT each other!
A single file (project.oop) becomes the source of truth for the entire project architecture. All modules, classes, methods, and their relationships are stored in one unified JSON structure.
Note: The entire project is built in just one file.
All nodes in the project (modules, classes, methods, attributes) are defined in a structured JSON format that is both human-readable and machine-parseable.
A natural-language section inside the JSON guiding AI tools to:
- Understand the hierarchy
- Interpret inheritance
- Reconstruct modules/classes/methods
- Generate consistent code
A controlled code generator that converts the JSON file into clean, synchronized source files, respecting OOP rules and maintaining code quality.
Graphical representation of the entire project structure with color-coded nodes and tree-based layout, allowing instant visual understanding.
Automatic detection and visualization of dependencies between project components, revealing hidden relationships.
- 📁 Projects are getting massive (1000+ classes, 5000+ methods)
- 🔍 Finding anything in traditional IDEs is slow and painful
- 🏗️ Understanding architecture takes months for new team members
- 🔗 Dependencies are invisible until something breaks
- 📊 No tool gives you a bird's eye view of your entire codebase
- 🔒 No control over critical components during development
O²Prex transforms how you interact with your codebase:
| Without O²Prex | With O²Prex |
|---|---|
| 📁 See files, not architecture | 🎨 See visual OOP structure in one canvas |
| 🔍 Slow, scattered search | ⚡ Live search with instant visual filtering |
| 🤷 No idea what depends on what | 🧩 Datum connections show all dependencies |
| 📅 Onboarding takes months | 🚀 Onboarding in days with visual navigation |
| 📝 Manual documentation | 🤖 AI-Ready export for automatic analysis |
| 🔒 No control over locked parts | 🔐 Lock/Suppress items for controlled development |
| 📂 Architecture scattered across files | 📄 Architecture-as-a-File single source of truth |
| 🔧 Manual code generation | ⚙️ Merge Engine for automated code generation |
See every Module, Class, Method, and Function in a beautiful, color-coded visual tree. Understand your entire project architecture in under 60 seconds.
Type any character and watch non-matching items fade to white while matches stay colorful. Matched items auto-unfold so you see them in context. Find anything in milliseconds.
One click reveals everything that uses a method/class and everything it uses. See hidden dependencies and understand impact of changes before you make them.
Search across code, tags, comments, and docstrings, then isolate only matching items. Focus on exactly what matters, zero distractions.
- Fold/Unfold to reduce visual clutter
- Move Mode to restructure visually (OOP rules enforced)
- Copy/Cut/Paste entire trees with automatic ID generation
- Undo/Redo for architecture changes
Ctrl+Double-click any item to open it in PyCharm , VScode (or any IDE) with:
- ✅ Auto-complete configured
- ✅ PYTHONPATH set
- ✅ File Watcher for instant sync
Changes in your IDE are instantly reflected back in O²Prex!
Export your entire project as JSONC with:
- Full tree structure
- All code with line numbers
- Docstrings and metadata
- AI-friendly comments with instructions (The entire project is collected in just one file.)
Feed it to ChatGPT, Claude, Gemini and get:
- 📊 Architecture analysis
- 💡 Improvement suggestions
- 📝 Auto-generated documentation
See every variable in your project (instance, class, local, instantiation, call) in one searchable table. Double-click to jump directly to the item in the canvas.
Manage projects with multiple languages (Python + C++ + Java) on the same canvas!
| Capability | VS Code | PyCharm | O²Prex |
|---|---|---|---|
| Write & Debug Code | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐ (Basic built-in) |
| Visual Architecture | ❌ | ❌ | ⭐⭐⭐⭐⭐ |
| Live Search with Filters | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| Isolation Mode | ❌ | ❌ | ⭐⭐⭐⭐⭐ |
| Dependency Analysis | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| Multi-language Projects | ❌ | ❌ | ⭐⭐⭐⭐⭐ (Future) |
| AI Integration | ⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ |
| OOP Architecture Control | ❌ | ❌ | ⭐⭐⭐⭐⭐ |
| Visual Project Management | ❌ | ❌ | ⭐⭐⭐⭐⭐ |
| Architecture-as-a-File | ❌ | ❌ | ⭐⭐⭐⭐⭐ |
| Merge Engine | ❌ | ❌ | ⭐⭐⭐⭐⭐ |
- Understand complex codebases instantly
- Navigate between components in seconds
- See hidden dependencies and avoid breaking changes
- Design and present architecture visually
- Analyze dependencies and identify risks
- Experiment with different architecture scenarios
- Track project status at a glance (flags + todos)
- Identify problem areas instantly
- Onboard new members 10x faster
- Reduce onboarding time from months to days
- Increase team productivity by up to 30%
- Standardize architecture across teams
- Single source of truth for project architecture
Add Modules, Classes, Methods, Functions visually. Each with color coding by type and stored in Architecture-as-a-File JSON format.
Use built-in editor or VS Code/PyCharm to write code in each item. O²Prex syncs automatically!
- Live Search to find anything instantly
- Datum Connections to see dependencies
- Isolation to focus on specific topics
- Track progress with Todos & Flags
- Lock/Suppress items for controlled development
- Fold/Unfold for clean view
- Merge Engine generates clean source code
- AI-Ready JSONC for ChatGPT/Claude
- Get automatic analysis and documentation
Before: 2-3 months to understand architecture
After: 2-3 days with visual navigation
Before: 30% time lost on navigation & searching
After: Everything is visual and searchable in milliseconds
Before: Hidden dependencies = surprise bugs
After: See all dependencies visually
Before: Manual architecture documentation
After: Auto-generated analysis from AI
Before: Anyone can break anything
After: Lock/Suppress critical components
Before: Architecture scattered across files
After: Complete architecture in one JSON file
- Python (Core)
- PyQt6 (GUI Framework)
- QGraphicsScene (Visual Canvas)
- AST (Code Analysis - Upcoming)
- JSONC (AI Export Format)
- PyQt6.QtSvg (Icon Rendering)
- QFileSystemWatcher (File Change Detection)
O²Prex/
├── src/ # Generated code output (optional)
├── docs/
│ ├── whitepaper.md # Technical whitepaper
│ └── business-proposal.md # Commercial overview
├── assets/
│ └── image/ # Icons and visual assets
├── LICENSE_PROPRIETARY.md # Commercial license
└── README.md # This file
- Visual OOP Architecture Canvas
- Live Search with Visual Filtering
- Datum Connections (Name-based analysis)
- Variable Inspector
- Todo Lists & Flags
- Lock/Suppress Controls
- AI-Ready Export (JSONC)
- VS Code Integration
- Move, Copy, Cut, Paste (Tree-based)
- Merge Engine
- Architecture-as-a-File
- Performance optimization
- Java & C++ & ... language support in one project and one File
- Git/GitHub/GitLab integration
- Team collaboration (comments, history)
- Multi-language projects (Python + C++ + Java)
- AI-powered architecture suggestions
- Design pattern detection
- Automated refactoring
- Full IDE ecosystem integration
This project is NOT open-source.
Per the Proprietary Commercial License, you may NOT:
- Copy or modify this project
- Use the architecture in any form
- Recreate the JSON model
- Implement the AI Header system
- Build derivative or competitive products
- Reverse-engineer or emulate the ideas
- Train AI models using this architecture
- Redistribute or share any part of the project
Commercial use requires a signed agreement.
For licensing inquiries:
Email: atila.gh@gmail.com
| Document | Description |
|---|---|
| Technical Whitepaper | Full technical explanation of architecture, JSON structure, Merge logic, and AI Header methodology |
| Business Proposal | Commercial strategy, target markets, product positioning |
| Proprietary License | Complete commercial license with all restrictions and terms |
Think of it like this:
VS Code/PyCharm = Your workshop tools (hammer, screwdriver)
O²Prex = The workshop manager that shows you where everything is and how it connects
Without O²Prex: You're working inside the code
With O²Prex: You're working above the code
- No tool gives you a true bird's eye view of your architecture
- No tool lets you isolate and focus with this precision
- No tool was designed from day one for AI integration
- No tool handles multi-language projects seamlessly
- No tool sits above the IDE layer — O²Prex does
- No tool implements Architecture-as-a-File
- No tool provides a Merge Engine for code generation
Atila Ghashghaie
Designer of Machinery & Electronic Circuits • Software Architecture Researcher
Email: atila.gh@gmail.com
Website: http://poyeshmashin.ir
If you're interested in collaboration, investment, licensing, or enterprise integration, feel free to reach out.
- Email: atila.gh@gmail.com
- Website: http://O2prex.ir
- Project: O²Prex - Visual OOP Architecture IDE
For licensing inquiries:
Email: atila.gh@gmail.com
O²Prex is the future of project management.
The Architecture Before the Code.
"O²Prex: The Architecture Before the Code."
© 2026 Atila Ghashghaie. All rights reserved.
This document is confidential and proprietary. Unauthorized distribution is prohibited.
Made with ❤️ for developers who want to see the big picture.