Getting Started

1. Clone the repository: bash git clone https://github.com/ALW1EZ/PANO.git cd PANO

2. Run the application:

3. Linux: ./start_pano.sh
4. Windows: start_pano.bat

The startup script will automatically: - Check for updates - Set up the Python environment - Install dependencies - Launch PANO

In order to use Email Lookup transform You need to login with GHunt first. After starting the pano via starter scripts;

1. Select venv manually
2. Linux: source venv/bin/activate
3. Windows: call venv\Scripts\activate
4. See how to login here

đŸ’Ą Quick Start Guide

1. Create Investigation: Start a new investigation or load an existing one
2. Add Entities: Drag entities from the sidebar onto the graph
3. Discover Connections: Use transforms to automatically find relationships
4. Analyze: Use timeline and map views to understand patterns
5. Save: Export your investigation for later use

đŸ” Features

đŸ•¸️ Core Functionality

• Interactive Graph Visualization
• Drag-and-drop entity creation
• Multiple layout algorithms (Circular, Hierarchical, Radial, Force-Directed)
• Dynamic relationship mapping

• Visual node and edge styling

• Timeline Analysis

• Chronological event visualization
• Interactive timeline navigation
• Event filtering and grouping

• Temporal relationship analysis

• Map Integration

• Geographic data visualization
• Location-based analysis
• Interactive mapping features
• Coordinate plotting and tracking

đŸŽŻ Entity Management

• Supported Entity Types
• đŸ“§ Email addresses
• đŸ‘¤ Usernames
• đŸŒ Websites
• đŸ–ź️ Images
• đŸ“ Locations
• ⏰ Events
• đŸ“ Text content
• đŸ”§ Custom entity types

đŸ”„ Transform System

• Email Analysis
• Google account investigation
• Calendar event extraction
• Location history analysis

• Connected services discovery

• Username Analysis

• Cross-platform username search
• Social media profile discovery
• Platform correlation

• Web presence analysis

• Image Analysis

• Reverse image search
• Visual content analysis
• Metadata extraction
• Related image discovery

đŸ¤– AI Integration

• PANAI
• Natural language investigation assistant
• Automated entity extraction and relationship mapping
• Pattern recognition and anomaly detection
• Multi-language support
• Context-aware suggestions
• Timeline and graph analysis

đŸ§Š Core Components

đŸ“Ś Entities

Entities are the fundamental building blocks of PANO. They represent distinct pieces of information that can be connected and analyzed:

• Built-in Types
• đŸ“§ Email: Email addresses with service detection
• đŸ‘¤ Username: Social media and platform usernames
• đŸŒ Website: Web pages with metadata
• đŸ–ź️ Image: Images with EXIF and analysis
• đŸ“ Location: Geographic coordinates and addresses
• ⏰ Event: Time-based occurrences

• đŸ“ Text: Generic text content

• Properties System

• Type-safe property validation
• Automatic property getters
• Dynamic property updates
• Custom property types
• Metadata support

⚡ Transforms

Transforms are automated operations that process entities to discover new information and relationships:

• Operation Types
• đŸ” Discovery: Find new entities from existing ones
• đŸ”— Correlation: Connect related entities
• đŸ“Š Analysis: Extract insights from entity data
• đŸŒ OSINT: Gather open-source intelligence

• đŸ”„ Enrichment: Add data to existing entities

• Features

• Async operation support
• Progress tracking
• Error handling
• Rate limiting
• Result validation

đŸ› ️ Helpers

Helpers are specialized tools with dedicated UIs for specific investigation tasks:

• Available Helpers
• đŸ” Cross-Examination: Analyze statements and testimonies
• đŸ‘¤ Portrait Creator: Generate facial composites
• đŸ“¸ Media Analyzer: Advanced image processing and analysis
• đŸ” Base Searcher: Search near places of interest

• đŸ”„ Translator: Translate text between languages

• Helper Features

• Custom Qt interfaces
• Real-time updates
• Graph integration
• Data visualization
• Export capabilities

đŸ‘Ľ Contributing

We welcome contributions! To contribute to PANO:

1. Fork the repository at https://github.com/ALW1EZ/PANO/
2. Make your changes in your fork
3. Test your changes thoroughly
4. Create a Pull Request to our main branch
5. In your PR description, include:
6. What the changes do
7. Why you made these changes
8. Any testing you've done
9. Screenshots if applicable

Note: We use a single main branch for development. All pull requests should be made directly to main.

đŸ“– Development Guide

from dataclasses import dataclassfrom typing import ClassVar, Dict, Anyfrom .base import Entity@dataclassclass PhoneNumber(Entity):    name: ClassVar[str] = "Phone Number"    description: ClassVar[str] = "A phone number entity with country code and validation"    def init_properties(self):        """Initialize phone number properties"""        self.setup_properties({            "number": str,            "country_code": str,            "carrier": str,            "type": str,  # mobile, landline, etc.            "verified": bool        })    def update_label(self):        """Update the display label"""        self.label = self.format_label(["country_code", "number"])

from dataclasses import dataclassfrom typing import ClassVar, Listfrom .base import Transformfrom entities.base import Entityfrom entities.phone_number import PhoneNumberfrom entities.location import Locationfrom ui.managers.status_manager import StatusManager@dataclassclass PhoneLookup(Transform):    name: ClassVar[str] = "Phone Number Lookup"    description: ClassVar[str] = "Lookup phone number details and location"    input_types: ClassVar[List[str]] = ["PhoneNumber"]    output_types: ClassVar[List[str]] = ["Location"]    async def run(self, entity: PhoneNumber, graph) -> List[Entity]:        if not isinstance(entity, PhoneNumber):            return []        status = StatusManager.get()        operation_id = status.start_loading("Phone Lookup")        try:            # Your phone number lookup logic here            # Example: query an API for phone number details            location = Location(properties={                "country": "Example Country",                "region": "Example Region",                "carrier": "Example Carrier",                "source": "PhoneLookup transform"            })            return [location]        except Exception as e:            status.set_text(f"Error during phone lookup: {str(e)}")            return []        finally:            status.stop_loading(operation_id)

from PySide6.QtWidgets import (    QWidget, QVBoxLayout, QHBoxLayout, QPushButton,    QTextEdit, QLabel, QComboBox)from .base import BaseHelperfrom qasync import asyncSlotclass DummyHelper(BaseHelper):    """A dummy helper for testing"""    name = "Dummy Helper"     description = "A dummy helper for testing"    def setup_ui(self):        """Initialize the helper's user interface"""        # Create input text area        self.input_label = QLabel("Input:")        self.input_text = QTextEdit()        self.input_text.setPlaceholderText("Enter text to process...")        self.input_text.setMinimumHeight(100)        # Create operation selector        operation_layout = QHBoxLayout()        self.operation_label = QLabel("Operation:")        self.operation_combo = QComboBox()        self.operation_combo.addItems(["Uppercase", "Lowercase", "Title Case"])        operation_layout.addWidget(self.operation_label)        operation_layout.addWidget(self.operation_combo)        # Create process button        self.process_btn = QPushButton("Process")        self.process_btn.clicked.connect(self.process_text)        # Create output text area        self.output_label = QLabel("Output:")        self.output_text = QTextEdit()        self.output_text.setReadOnly(True)        self.output_text.setMinimumHeight(100)        # Add widgets to main layout        self.main_layout.addWidget(self.input_label)        self.main_layout.addWidget(self.input_text)        self.main_layout.addLayout(operation_layout)        self.main_layout.addWidget(self.process_btn)        self.main_layout.addWidget(self.output_label)        self.main_layout.addWidget(self.output_text)        # Set dialog size        self.resize(400, 500)    @asyncSlot()    async def process_text(self):        """Process the input text based on selected operation"""        text = self.input_text.toPlainText()        operation = self.operation_combo.currentText()        if operation == "Uppercase":            result = text.upper()        elif operation == "Lowercase":            result = text.lower()        else:  # Title Case            result = text.title()        self.output_text.setPlainText(result)

đŸ“„ License

This project is licensed under the Creative Commons Attribution-NonCommercial (CC BY-NC) License.

You are free to: - ✅ Share: Copy and redistribute the material - ✅ Adapt: Remix, transform, and build upon the material

Under these terms: - â„š️ Attribution: You must give appropriate credit - đŸšŤ NonCommercial: No commercial use - đŸ”“ No additional restrictions

đŸ™ Acknowledgments

Special thanks to all library authors and contributors who made this project possible.

đŸ‘¨‍đŸ’ť Author

Created by ALW1EZ with AI ❤️