forensic-cli 1.2.6__tar.gz → 1.2.8__tar.gz

{forensic_cli-1.2.6/src/forensic_cli.egg-info → forensic_cli-1.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forensic-cli
-Version: 1.2.6
+Version: 1.2.8
 Summary: DevKit Forense - CLI para análise de navegadores e rede
 Home-page: https://github.com/ErickG123/devkit_forense
 Author: Erick Gabriel dos Santos Alves
@@ -8,6 +8,7 @@ Author-email: Erick Gabriel dos Santos Alves <erickgabrielalves0@gmail.com>
 License: MIT
 Project-URL: Changelog, https://erickg123.github.io/devkit_forense/
 Project-URL: Source, https://github.com/ErickG123/devkit_forense
+Project-URL: Issues, https://github.com/ErickG123/devkit_forense/issues
 Keywords: forensics,cli,network,browser
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -29,7 +30,6 @@ Requires-Dist: defusedxml==0.7.1
 Requires-Dist: dnspython==2.7.0
 Requires-Dist: docopt==0.6.2
 Requires-Dist: docutils==0.22
-Requires-Dist: fastapi==0.116.1
 Requires-Dist: fonttools==4.59.1
 Requires-Dist: greenlet==3.2.4
 Requires-Dist: h11==0.16.0
@@ -77,7 +77,6 @@ Requires-Dist: six==1.17.0
 Requires-Dist: smbprotocol==1.15.0
 Requires-Dist: sniffio==1.3.1
 Requires-Dist: sortedcontainers==2.4.0
-Requires-Dist: SQLAlchemy==2.0.43
 Requires-Dist: starlette==0.47.2
 Requires-Dist: trio==0.30.0
 Requires-Dist: trio-websocket==0.12.2
@@ -86,7 +85,6 @@ Requires-Dist: typing-inspection==0.4.1
 Requires-Dist: typing_extensions==4.14.1
 Requires-Dist: tzdata==2025.2
 Requires-Dist: urllib3==2.5.0
-Requires-Dist: uvicorn==0.35.0
 Requires-Dist: websocket-client==1.8.0
 Requires-Dist: wsproto==1.2.0
 Requires-Dist: yarg==0.1.10
@@ -106,16 +104,10 @@ Dynamic: requires-python
    - [Network](#network)  
    - [Browser](#browser)  
    - [Email](#email)  
-4. [Aplicações de Apoio](#aplicações-de-apoio)  
-   - [Dashboard](#dashboard)  
-   - [Visualizadores de Resultados](#visualizadores-de-resultados)  
-   - [Assistente Interativo (Wizard)](#assistente-interativo-wizard)  
-5. [Fluxo de Integração](#fluxo-de-integração)  
-6. [Tecnologias Utilizadas](#tecnologias-utilizadas)  
-7. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)  
-8. [Instalação](#instalação)  
-9. [Exemplos de Execução](#exemplos-de-execução)  
-10. [Considerações Finais](#considerações-finais)
+4. [Tecnologias Utilizadas](#tecnologias-utilizadas)  
+5. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)  
+6. [Instalação](#instalação)  
+7. [Exemplos de Execução](#exemplos-de-execução)  
 
 ---
 
@@ -148,84 +140,38 @@ O DevKit está organizado em três camadas principais:
 ## 3. Módulos Forenses
 
 ### Network
-| Módulo | Descrição |
+| Função | Descrição |
 |--------|-----------|
-| `ip_info` | Consulta informações detalhadas sobre um endereço IP. |
-| `arp_scan` | Varre a rede para identificar dispositivos conectados via ARP. |
-| `dns_recon` | Realiza levantamento de informações de DNS de domínios e hosts. |
-| `snmp_scan` | Realiza varredura SNMP em dispositivos de rede. |
-| `ping_sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
+| `ipinfo` | Consulta informações detalhadas sobre um endereço IP. |
+| `arpscan` | Varre a rede para identificar dispositivos conectados via ARP. |
+| `dnscan` | Realiza levantamento de informações de DNS de domínios e hosts. |
+| `snmpscan` | Realiza varredura SNMP em dispositivos de rede. |
+| `smbscan` | Verifica serviços SMB ativos em um host . |
+| `sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
 | `traceroute` | Traça o caminho percorrido por pacotes até um host alvo. |
-| `network_map` | Gera mapa visual de hosts e conexões detectadas. |
-| `port_scanner` | Identifica portas abertas e serviços ativos em hosts. |
+| `map` | Gera mapa visual de hosts e conexões detectadas. |
+| `scan` | Identifica portas abertas e serviços ativos em hosts. |
 | `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
 
 ### Browser
-| Módulo | Descrição |
+| Função | Descrição |
 |--------|-----------|
 | `logins` | Extração de credenciais armazenadas no Chrome e Edge. |
-| `fav_screen` | Captura e organiza screenshots de sites favoritos ou acessados. |
-| `common_words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
-| `browser_history` | Coleta histórico de navegação de diferentes browsers. |
-| `unusual_patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
-| `downloads_history` | Lista arquivos baixados pelos usuários. |
+| `favscreen` | Captura e organiza screenshots de sites favoritos ou acessados. |
+| `words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
+| `history` | Coleta histórico de navegação de diferentes browsers. |
+| `patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
+| `downloads` | Lista arquivos baixados pelos usuários. |
 
 ### Email
-| Módulo | Descrição |
+| Função | Descrição |
 |--------|-----------|
 | `email_parser` | Extrai e organiza informações de emails. |
 | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
 
 ---
 
-## 4. Aplicações de Apoio
-
-### Dashboard
-**Objetivo:** Centralizar informações e permitir execução rápida de módulos.  
-
-**Funcionalidades:**  
-- Menu lateral com módulos do DevKit.  
-- Cards com resumo de análises recentes.  
-- Acesso direto a visualizadores e Wizard.  
-
-**Tecnologias sugeridas:** Streamlit (web), PyQt (desktop).  
-
-### Visualizadores de Resultados
-**Objetivo:** Transformar saídas da CLI em gráficos e tabelas interativas.  
-
-**Exemplos:**  
-- Mapas de rede interativos.  
-- Timeline de eventos e logs.  
-- Gráficos de arquivos analisados, tipos e padrões suspeitos.  
-
-**Integração:** Recebe dados da CLI em formato JSON ou CSV.  
-
-### Assistente Interativo (Wizard)
-**Objetivo:** Guiar o usuário passo a passo em tarefas complexas.  
-
-**Exemplo de fluxo:**  
-1. Seleção do tipo de análise (pendrive, rede, logs, etc.)  
-2. Configuração de opções (scan de malware, intervalo de IP, dispositivo alvo)  
-3. Execução automática dos módulos necessários  
-4. Geração de relatórios e acesso aos visualizadores  
-
-**Tecnologias sugeridas:**  
-- Terminal interativo (`questionary`, `PyInquirer`)  
-- Web/Desktop (mesmo framework do Dashboard)  
-
----
-
-## 5. Fluxo de Integração
-
-1. CLI executa módulos → gera resultados.  
-2. API possibilita integração programática com dashboards e outras aplicações.  
-3. Dashboard centraliza execução e resumo dos resultados.  
-4. Visualizadores transformam dados em gráficos e tabelas interativas.  
-5. Wizard guia o usuário em tarefas complexas.  
-
----
-
-## 6. Tecnologias Utilizadas
+## 4. Tecnologias Utilizadas
 
 - **Python** – Linguagem principal do projeto.  
 - **FastAPI** – API para integração e execução de módulos.  
@@ -234,7 +180,7 @@ O DevKit está organizado em três camadas principais:
 
 ---
 
-## 7. Planejamento e Futuras Extensões
+## 5. Planejamento e Futuras Extensões
 
 | Aplicação / Módulo | Objetivo | Possíveis Extensões |
 |-------------------|----------|------------------|
@@ -246,33 +192,23 @@ O DevKit está organizado em três camadas principais:
 
 ---
 
-## 8. Instalação
+## 6. Instalação
 
 ```bash
-# Clonar o repositório
-git clone https://github.com/ErickG123/devkit_forense.git
-cd devkit-forense
-
-# Criar ambiente virtual
-python -m venv venv
-source venv/bin/activate  # Linux/macOS
-venv\Scripts\activate    # Windows
-
-# Instalar dependências
-pip install -r requirements.txt
+pip install forensic-cli
 ```
 
 ---
 
-## 9. Exemplos de Execução
+## 7. Exemplos de Execução
 
 **CLI:**
 ```bash
 # Executar módulo de network scan
-python cli.py network_map --target 192.168.0.0/24
+forensic-cli network map --network 192.168.0.0/24
 
 # Coletar histórico do Chrome
-python cli.py browser_history --browser chrome
+forensic-cli browser history --chrome
 ```
 
 **API:**
@@ -280,11 +216,3 @@ python cli.py browser_history --browser chrome
 # Executar API
 uvicorn api.main:app --reload
 ```
-
----
-
-## 10. Considerações Finais
-
-O DevKit Forense combina **educação e prática**, permitindo que usuários explorem análise forense digital de forma segura, didática e interativa.  
-As aplicações de apoio aumentam a acessibilidade e engajamento, tornando o estudo da perícia digital mais visual e intuitivo.  
-O planejamento de novos módulos e ferramentas garante evolução contínua da plataforma, mantendo-a atualizada e relevante para atividades acadêmicas e laboratoriais.

forensic_cli-1.2.8/README.md

@@ -0,0 +1,123 @@
+# DevKit Forense – Ferramenta Educacional de Perícia Digital
+
+![Python](https://img.shields.io/badge/Python-3.11-blue.svg) ![FastAPI](https://img.shields.io/badge/FastAPI-0.100-green.svg) ![Typer](https://img.shields.io/badge/Typer-0.7-orange.svg) ![SQLite](https://img.shields.io/badge/SQLite-3.41.2-lightgrey.svg)
+
+## Sumário
+1. [Introdução](#introdução)  
+2. [Estrutura do Projeto](#estrutura-do-projeto)  
+3. [Módulos Forenses](#módulos-forenses)  
+   - [Network](#network)  
+   - [Browser](#browser)  
+   - [Email](#email)  
+4. [Tecnologias Utilizadas](#tecnologias-utilizadas)  
+5. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)  
+6. [Instalação](#instalação)  
+7. [Exemplos de Execução](#exemplos-de-execução)  
+
+---
+
+## 1. Introdução
+
+**Objetivo:**  
+O DevKit Forense é uma suíte de ferramentas educacionais para análise de evidências digitais, projetada para auxiliar no ensino de perícia digital. Combina **CLI**, **API** e **aplicações de apoio**, tornando o uso mais interativo, visual e didático.  
+
+**Escopo:**  
+- Execução de análises forenses em browsers, arquivos, emails e redes.  
+- Visualização interativa de resultados.  
+- Geração de relatórios automáticos.  
+- Assistente interativo (Wizard) para guiar o usuário em tarefas complexas.  
+
+**Público-alvo:**  
+- Estudantes e professores de Segurança da Informação e Perícia Digital.  
+
+---
+
+## 2. Estrutura do Projeto
+
+O DevKit está organizado em três camadas principais:
+
+1. **CLI** – Executa os módulos forenses pelo terminal.  
+2. **API** – Interface programática para execução de módulos e integração com dashboards.  
+3. **Core** – Contém a lógica central, classes, funções e utilitários compartilhados pelos módulos.  
+
+---
+
+## 3. Módulos Forenses
+
+### Network
+| Função | Descrição |
+|--------|-----------|
+| `ipinfo` | Consulta informações detalhadas sobre um endereço IP. |
+| `arpscan` | Varre a rede para identificar dispositivos conectados via ARP. |
+| `dnscan` | Realiza levantamento de informações de DNS de domínios e hosts. |
+| `snmpscan` | Realiza varredura SNMP em dispositivos de rede. |
+| `smbscan` | Verifica serviços SMB ativos em um host . |
+| `sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
+| `traceroute` | Traça o caminho percorrido por pacotes até um host alvo. |
+| `map` | Gera mapa visual de hosts e conexões detectadas. |
+| `scan` | Identifica portas abertas e serviços ativos em hosts. |
+| `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
+
+### Browser
+| Função | Descrição |
+|--------|-----------|
+| `logins` | Extração de credenciais armazenadas no Chrome e Edge. |
+| `favscreen` | Captura e organiza screenshots de sites favoritos ou acessados. |
+| `words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
+| `history` | Coleta histórico de navegação de diferentes browsers. |
+| `patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
+| `downloads` | Lista arquivos baixados pelos usuários. |
+
+### Email
+| Função | Descrição |
+|--------|-----------|
+| `email_parser` | Extrai e organiza informações de emails. |
+| `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
+
+---
+
+## 4. Tecnologias Utilizadas
+
+- **Python** – Linguagem principal do projeto.  
+- **FastAPI** – API para integração e execução de módulos.  
+- **Typer** – CLI estruturada e interativa.  
+- **SQLite** – Banco de dados local leve.  
+
+---
+
+## 5. Planejamento e Futuras Extensões
+
+| Aplicação / Módulo | Objetivo | Possíveis Extensões |
+|-------------------|----------|------------------|
+| Dashboard | Painel central para visualização e execução de módulos | Filtros avançados, alertas em tempo real, integração direta com relatórios |
+| Visualizadores | Transformar dados da CLI em gráficos, mapas e tabelas | Timeline interativa, heatmaps de rede, gráficos de comportamento de usuários |
+| Wizard | Guiar o usuário passo a passo | Templates de análise rápida, integração automática com módulos de email e data, relatórios PDF/HTML |
+| Novos módulos CLI | Expansão da análise forense | Logs de sistemas, recuperação de dispositivos móveis, análise de mídia, detecção de malware, integração com threat intelligence |
+| Ferramentas auxiliares | Suporte a módulos existentes e novos | Exportação avançada de relatórios, dashboards customizáveis, notificações em tempo real |
+
+---
+
+## 6. Instalação
+
+```bash
+pip install forensic-cli
+```
+
+---
+
+## 7. Exemplos de Execução
+
+**CLI:**
+```bash
+# Executar módulo de network scan
+forensic-cli network map --network 192.168.0.0/24
+
+# Coletar histórico do Chrome
+forensic-cli browser history --chrome
+```
+
+**API:**
+```bash
+# Executar API
+uvicorn api.main:app --reload
+```

{forensic_cli-1.2.6 → forensic_cli-1.2.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "forensic-cli"
-version = "1.2.6"
+version = "1.2.8"
 description = "DevKit Forense - CLI para análise de navegadores e rede"
 readme = "README.md"
 license = {text = "MIT"}
@@ -31,7 +31,6 @@ dependencies = [
     "dnspython==2.7.0",
     "docopt==0.6.2",
     "docutils==0.22",
-    "fastapi==0.116.1",
     "fonttools==4.59.1",
     "greenlet==3.2.4",
     "h11==0.16.0",
@@ -79,7 +78,6 @@ dependencies = [
     "smbprotocol==1.15.0",
     "sniffio==1.3.1",
     "sortedcontainers==2.4.0",
-    "SQLAlchemy==2.0.43",
     "starlette==0.47.2",
     "trio==0.30.0",
     "trio-websocket==0.12.2",
@@ -88,7 +86,6 @@ dependencies = [
     "typing_extensions==4.14.1",
     "tzdata==2025.2",
     "urllib3==2.5.0",
-    "uvicorn==0.35.0",
     "websocket-client==1.8.0",
     "wsproto==1.2.0",
     "yarg==0.1.10"
@@ -104,3 +101,4 @@ forensic-cli = "cli.main:app"
 [project.urls]
 Changelog = "https://erickg123.github.io/devkit_forense/"
 Source = "https://github.com/ErickG123/devkit_forense"
+Issues = "https://github.com/ErickG123/devkit_forense/issues"

{forensic_cli-1.2.6 → forensic_cli-1.2.8}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="forensic_cli",
-    version="1.2.6",
+    version="1.2.8",
     author="Erick Gabriel dos Santos Alves",
     author_email="erickgabrielalves0@gmail.com",
     description="Toolkit modular para análise de evidências digitais",

{forensic_cli-1.2.6 → forensic_cli-1.2.8}/src/cli/commands/network.py

@@ -18,7 +18,7 @@ network_app = typer.Typer(help="Conjunto de ferramentas para análise e explora
 @network_app.command("map", help="Mapeia dispositivos ativos na rede e salva os resultados em JSON/CSV")
 def map(
     network: str = typer.Option(..., help="Range de IPs da rede. Exemplo: 192.168.1.1-254"),
-    output_dir: str = typer.Option("../../output", help="Diretório para salvar os resultados"),
+    output_dir: str = typer.Option("./output", help="Diretório para salvar os resultados"),
 ):
     result = run_network_map(network, output_dir)
     typer.echo(f"Resultados salvos em: {result['json_file']} e {result['csv_file']}")

forensic_cli-1.2.8/src/core/network/arp_scan.py

@@ -0,0 +1,38 @@
+import typer
+import ipaddress
+from scapy.all import ARP, Ether, srp, sr1, IP, ICMP
+
+def is_valid_ip(addr: str) -> bool:
+    try:
+        ipaddress.ip_address(addr)
+        return True
+    except ValueError:
+        return False
+
+def arp_scan(network_ips):
+    active_hosts = []
+
+    ips = [ip for ip in network_ips if is_valid_ip(ip)]
+
+    typer.echo(f"[+] Iniciando ARP scan ({len(ips)} IPs)...")
+
+    with typer.progressbar(ips, label="ARP Scan") as progress:
+        for ip in ips:
+            try:
+                pkt = Ether(dst="ff:ff:ff:ff:ff:ff") / ARP(pdst=ip)
+                ans, _ = srp(pkt, timeout=1, verbose=0)
+                if ans:
+                    active_hosts.append(ip)
+
+            except Exception:
+                try:
+                    pkt = IP(dst=ip) / ICMP()
+                    resp = sr1(pkt, timeout=1, verbose=0)
+                    if resp:
+                        active_hosts.append(ip)
+                except Exception:
+                    pass
+
+            progress.update(1)
+
+    return active_hosts

{forensic_cli-1.2.6 → forensic_cli-1.2.8/src/forensic_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forensic-cli
-Version: 1.2.6
+Version: 1.2.8
 Summary: DevKit Forense - CLI para análise de navegadores e rede
 Home-page: https://github.com/ErickG123/devkit_forense
 Author: Erick Gabriel dos Santos Alves
@@ -8,6 +8,7 @@ Author-email: Erick Gabriel dos Santos Alves <erickgabrielalves0@gmail.com>
 License: MIT
 Project-URL: Changelog, https://erickg123.github.io/devkit_forense/
 Project-URL: Source, https://github.com/ErickG123/devkit_forense
+Project-URL: Issues, https://github.com/ErickG123/devkit_forense/issues
 Keywords: forensics,cli,network,browser
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -29,7 +30,6 @@ Requires-Dist: defusedxml==0.7.1
 Requires-Dist: dnspython==2.7.0
 Requires-Dist: docopt==0.6.2
 Requires-Dist: docutils==0.22
-Requires-Dist: fastapi==0.116.1
 Requires-Dist: fonttools==4.59.1
 Requires-Dist: greenlet==3.2.4
 Requires-Dist: h11==0.16.0
@@ -77,7 +77,6 @@ Requires-Dist: six==1.17.0
 Requires-Dist: smbprotocol==1.15.0
 Requires-Dist: sniffio==1.3.1
 Requires-Dist: sortedcontainers==2.4.0
-Requires-Dist: SQLAlchemy==2.0.43
 Requires-Dist: starlette==0.47.2
 Requires-Dist: trio==0.30.0
 Requires-Dist: trio-websocket==0.12.2
@@ -86,7 +85,6 @@ Requires-Dist: typing-inspection==0.4.1
 Requires-Dist: typing_extensions==4.14.1
 Requires-Dist: tzdata==2025.2
 Requires-Dist: urllib3==2.5.0
-Requires-Dist: uvicorn==0.35.0
 Requires-Dist: websocket-client==1.8.0
 Requires-Dist: wsproto==1.2.0
 Requires-Dist: yarg==0.1.10
@@ -106,16 +104,10 @@ Dynamic: requires-python
    - [Network](#network)  
    - [Browser](#browser)  
    - [Email](#email)  
-4. [Aplicações de Apoio](#aplicações-de-apoio)  
-   - [Dashboard](#dashboard)  
-   - [Visualizadores de Resultados](#visualizadores-de-resultados)  
-   - [Assistente Interativo (Wizard)](#assistente-interativo-wizard)  
-5. [Fluxo de Integração](#fluxo-de-integração)  
-6. [Tecnologias Utilizadas](#tecnologias-utilizadas)  
-7. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)  
-8. [Instalação](#instalação)  
-9. [Exemplos de Execução](#exemplos-de-execução)  
-10. [Considerações Finais](#considerações-finais)
+4. [Tecnologias Utilizadas](#tecnologias-utilizadas)  
+5. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)  
+6. [Instalação](#instalação)  
+7. [Exemplos de Execução](#exemplos-de-execução)  
 
 ---
 
@@ -148,84 +140,38 @@ O DevKit está organizado em três camadas principais:
 ## 3. Módulos Forenses
 
 ### Network
-| Módulo | Descrição |
+| Função | Descrição |
 |--------|-----------|
-| `ip_info` | Consulta informações detalhadas sobre um endereço IP. |
-| `arp_scan` | Varre a rede para identificar dispositivos conectados via ARP. |
-| `dns_recon` | Realiza levantamento de informações de DNS de domínios e hosts. |
-| `snmp_scan` | Realiza varredura SNMP em dispositivos de rede. |
-| `ping_sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
+| `ipinfo` | Consulta informações detalhadas sobre um endereço IP. |
+| `arpscan` | Varre a rede para identificar dispositivos conectados via ARP. |
+| `dnscan` | Realiza levantamento de informações de DNS de domínios e hosts. |
+| `snmpscan` | Realiza varredura SNMP em dispositivos de rede. |
+| `smbscan` | Verifica serviços SMB ativos em um host . |
+| `sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
 | `traceroute` | Traça o caminho percorrido por pacotes até um host alvo. |
-| `network_map` | Gera mapa visual de hosts e conexões detectadas. |
-| `port_scanner` | Identifica portas abertas e serviços ativos em hosts. |
+| `map` | Gera mapa visual de hosts e conexões detectadas. |
+| `scan` | Identifica portas abertas e serviços ativos em hosts. |
 | `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
 
 ### Browser
-| Módulo | Descrição |
+| Função | Descrição |
 |--------|-----------|
 | `logins` | Extração de credenciais armazenadas no Chrome e Edge. |
-| `fav_screen` | Captura e organiza screenshots de sites favoritos ou acessados. |
-| `common_words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
-| `browser_history` | Coleta histórico de navegação de diferentes browsers. |
-| `unusual_patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
-| `downloads_history` | Lista arquivos baixados pelos usuários. |
+| `favscreen` | Captura e organiza screenshots de sites favoritos ou acessados. |
+| `words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
+| `history` | Coleta histórico de navegação de diferentes browsers. |
+| `patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
+| `downloads` | Lista arquivos baixados pelos usuários. |
 
 ### Email
-| Módulo | Descrição |
+| Função | Descrição |
 |--------|-----------|
 | `email_parser` | Extrai e organiza informações de emails. |
 | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
 
 ---
 
-## 4. Aplicações de Apoio
-
-### Dashboard
-**Objetivo:** Centralizar informações e permitir execução rápida de módulos.  
-
-**Funcionalidades:**  
-- Menu lateral com módulos do DevKit.  
-- Cards com resumo de análises recentes.  
-- Acesso direto a visualizadores e Wizard.  
-
-**Tecnologias sugeridas:** Streamlit (web), PyQt (desktop).  
-
-### Visualizadores de Resultados
-**Objetivo:** Transformar saídas da CLI em gráficos e tabelas interativas.  
-
-**Exemplos:**  
-- Mapas de rede interativos.  
-- Timeline de eventos e logs.  
-- Gráficos de arquivos analisados, tipos e padrões suspeitos.  
-
-**Integração:** Recebe dados da CLI em formato JSON ou CSV.  
-
-### Assistente Interativo (Wizard)
-**Objetivo:** Guiar o usuário passo a passo em tarefas complexas.  
-
-**Exemplo de fluxo:**  
-1. Seleção do tipo de análise (pendrive, rede, logs, etc.)  
-2. Configuração de opções (scan de malware, intervalo de IP, dispositivo alvo)  
-3. Execução automática dos módulos necessários  
-4. Geração de relatórios e acesso aos visualizadores  
-
-**Tecnologias sugeridas:**  
-- Terminal interativo (`questionary`, `PyInquirer`)  
-- Web/Desktop (mesmo framework do Dashboard)  
-
----
-
-## 5. Fluxo de Integração
-
-1. CLI executa módulos → gera resultados.  
-2. API possibilita integração programática com dashboards e outras aplicações.  
-3. Dashboard centraliza execução e resumo dos resultados.  
-4. Visualizadores transformam dados em gráficos e tabelas interativas.  
-5. Wizard guia o usuário em tarefas complexas.  
-
----
-
-## 6. Tecnologias Utilizadas
+## 4. Tecnologias Utilizadas
 
 - **Python** – Linguagem principal do projeto.  
 - **FastAPI** – API para integração e execução de módulos.  
@@ -234,7 +180,7 @@ O DevKit está organizado em três camadas principais:
 
 ---
 
-## 7. Planejamento e Futuras Extensões
+## 5. Planejamento e Futuras Extensões
 
 | Aplicação / Módulo | Objetivo | Possíveis Extensões |
 |-------------------|----------|------------------|
@@ -246,33 +192,23 @@ O DevKit está organizado em três camadas principais:
 
 ---
 
-## 8. Instalação
+## 6. Instalação
 
 ```bash
-# Clonar o repositório
-git clone https://github.com/ErickG123/devkit_forense.git
-cd devkit-forense
-
-# Criar ambiente virtual
-python -m venv venv
-source venv/bin/activate  # Linux/macOS
-venv\Scripts\activate    # Windows
-
-# Instalar dependências
-pip install -r requirements.txt
+pip install forensic-cli
 ```
 
 ---
 
-## 9. Exemplos de Execução
+## 7. Exemplos de Execução
 
 **CLI:**
 ```bash
 # Executar módulo de network scan
-python cli.py network_map --target 192.168.0.0/24
+forensic-cli network map --network 192.168.0.0/24
 
 # Coletar histórico do Chrome
-python cli.py browser_history --browser chrome
+forensic-cli browser history --chrome
 ```
 
 **API:**
@@ -280,11 +216,3 @@ python cli.py browser_history --browser chrome
 # Executar API
 uvicorn api.main:app --reload
 ```
-
----
-
-## 10. Considerações Finais
-
-O DevKit Forense combina **educação e prática**, permitindo que usuários explorem análise forense digital de forma segura, didática e interativa.  
-As aplicações de apoio aumentam a acessibilidade e engajamento, tornando o estudo da perícia digital mais visual e intuitivo.  
-O planejamento de novos módulos e ferramentas garante evolução contínua da plataforma, mantendo-a atualizada e relevante para atividades acadêmicas e laboratoriais.

{forensic_cli-1.2.6 → forensic_cli-1.2.8}/src/forensic_cli.egg-info/requires.txt

@@ -14,7 +14,6 @@ defusedxml==0.7.1
 dnspython==2.7.0
 docopt==0.6.2
 docutils==0.22
-fastapi==0.116.1
 fonttools==4.59.1
 greenlet==3.2.4
 h11==0.16.0
@@ -62,7 +61,6 @@ six==1.17.0
 smbprotocol==1.15.0
 sniffio==1.3.1
 sortedcontainers==2.4.0
-SQLAlchemy==2.0.43
 starlette==0.47.2
 trio==0.30.0
 trio-websocket==0.12.2
@@ -71,7 +69,6 @@ typing-inspection==0.4.1
 typing_extensions==4.14.1
 tzdata==2025.2
 urllib3==2.5.0
-uvicorn==0.35.0
 websocket-client==1.8.0
 wsproto==1.2.0
 yarg==0.1.10

forensic_cli-1.2.6/README.md

@@ -1,193 +0,0 @@
-# DevKit Forense – Ferramenta Educacional de Perícia Digital
-
-![Python](https://img.shields.io/badge/Python-3.11-blue.svg) ![FastAPI](https://img.shields.io/badge/FastAPI-0.100-green.svg) ![Typer](https://img.shields.io/badge/Typer-0.7-orange.svg) ![SQLite](https://img.shields.io/badge/SQLite-3.41.2-lightgrey.svg)
-
-## Sumário
-1. [Introdução](#introdução)  
-2. [Estrutura do Projeto](#estrutura-do-projeto)  
-3. [Módulos Forenses](#módulos-forenses)  
-   - [Network](#network)  
-   - [Browser](#browser)  
-   - [Email](#email)  
-4. [Aplicações de Apoio](#aplicações-de-apoio)  
-   - [Dashboard](#dashboard)  
-   - [Visualizadores de Resultados](#visualizadores-de-resultados)  
-   - [Assistente Interativo (Wizard)](#assistente-interativo-wizard)  
-5. [Fluxo de Integração](#fluxo-de-integração)  
-6. [Tecnologias Utilizadas](#tecnologias-utilizadas)  
-7. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)  
-8. [Instalação](#instalação)  
-9. [Exemplos de Execução](#exemplos-de-execução)  
-10. [Considerações Finais](#considerações-finais)
-
----
-
-## 1. Introdução
-
-**Objetivo:**  
-O DevKit Forense é uma suíte de ferramentas educacionais para análise de evidências digitais, projetada para auxiliar no ensino de perícia digital. Combina **CLI**, **API** e **aplicações de apoio**, tornando o uso mais interativo, visual e didático.  
-
-**Escopo:**  
-- Execução de análises forenses em browsers, arquivos, emails e redes.  
-- Visualização interativa de resultados.  
-- Geração de relatórios automáticos.  
-- Assistente interativo (Wizard) para guiar o usuário em tarefas complexas.  
-
-**Público-alvo:**  
-- Estudantes e professores de Segurança da Informação e Perícia Digital.  
-
----
-
-## 2. Estrutura do Projeto
-
-O DevKit está organizado em três camadas principais:
-
-1. **CLI** – Executa os módulos forenses pelo terminal.  
-2. **API** – Interface programática para execução de módulos e integração com dashboards.  
-3. **Core** – Contém a lógica central, classes, funções e utilitários compartilhados pelos módulos.  
-
----
-
-## 3. Módulos Forenses
-
-### Network
-| Módulo | Descrição |
-|--------|-----------|
-| `ip_info` | Consulta informações detalhadas sobre um endereço IP. |
-| `arp_scan` | Varre a rede para identificar dispositivos conectados via ARP. |
-| `dns_recon` | Realiza levantamento de informações de DNS de domínios e hosts. |
-| `snmp_scan` | Realiza varredura SNMP em dispositivos de rede. |
-| `ping_sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
-| `traceroute` | Traça o caminho percorrido por pacotes até um host alvo. |
-| `network_map` | Gera mapa visual de hosts e conexões detectadas. |
-| `port_scanner` | Identifica portas abertas e serviços ativos em hosts. |
-| `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
-
-### Browser
-| Módulo | Descrição |
-|--------|-----------|
-| `logins` | Extração de credenciais armazenadas no Chrome e Edge. |
-| `fav_screen` | Captura e organiza screenshots de sites favoritos ou acessados. |
-| `common_words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
-| `browser_history` | Coleta histórico de navegação de diferentes browsers. |
-| `unusual_patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
-| `downloads_history` | Lista arquivos baixados pelos usuários. |
-
-### Email
-| Módulo | Descrição |
-|--------|-----------|
-| `email_parser` | Extrai e organiza informações de emails. |
-| `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
-
----
-
-## 4. Aplicações de Apoio
-
-### Dashboard
-**Objetivo:** Centralizar informações e permitir execução rápida de módulos.  
-
-**Funcionalidades:**  
-- Menu lateral com módulos do DevKit.  
-- Cards com resumo de análises recentes.  
-- Acesso direto a visualizadores e Wizard.  
-
-**Tecnologias sugeridas:** Streamlit (web), PyQt (desktop).  
-
-### Visualizadores de Resultados
-**Objetivo:** Transformar saídas da CLI em gráficos e tabelas interativas.  
-
-**Exemplos:**  
-- Mapas de rede interativos.  
-- Timeline de eventos e logs.  
-- Gráficos de arquivos analisados, tipos e padrões suspeitos.  
-
-**Integração:** Recebe dados da CLI em formato JSON ou CSV.  
-
-### Assistente Interativo (Wizard)
-**Objetivo:** Guiar o usuário passo a passo em tarefas complexas.  
-
-**Exemplo de fluxo:**  
-1. Seleção do tipo de análise (pendrive, rede, logs, etc.)  
-2. Configuração de opções (scan de malware, intervalo de IP, dispositivo alvo)  
-3. Execução automática dos módulos necessários  
-4. Geração de relatórios e acesso aos visualizadores  
-
-**Tecnologias sugeridas:**  
-- Terminal interativo (`questionary`, `PyInquirer`)  
-- Web/Desktop (mesmo framework do Dashboard)  
-
----
-
-## 5. Fluxo de Integração
-
-1. CLI executa módulos → gera resultados.  
-2. API possibilita integração programática com dashboards e outras aplicações.  
-3. Dashboard centraliza execução e resumo dos resultados.  
-4. Visualizadores transformam dados em gráficos e tabelas interativas.  
-5. Wizard guia o usuário em tarefas complexas.  
-
----
-
-## 6. Tecnologias Utilizadas
-
-- **Python** – Linguagem principal do projeto.  
-- **FastAPI** – API para integração e execução de módulos.  
-- **Typer** – CLI estruturada e interativa.  
-- **SQLite** – Banco de dados local leve.  
-
----
-
-## 7. Planejamento e Futuras Extensões
-
-| Aplicação / Módulo | Objetivo | Possíveis Extensões |
-|-------------------|----------|------------------|
-| Dashboard | Painel central para visualização e execução de módulos | Filtros avançados, alertas em tempo real, integração direta com relatórios |
-| Visualizadores | Transformar dados da CLI em gráficos, mapas e tabelas | Timeline interativa, heatmaps de rede, gráficos de comportamento de usuários |
-| Wizard | Guiar o usuário passo a passo | Templates de análise rápida, integração automática com módulos de email e data, relatórios PDF/HTML |
-| Novos módulos CLI | Expansão da análise forense | Logs de sistemas, recuperação de dispositivos móveis, análise de mídia, detecção de malware, integração com threat intelligence |
-| Ferramentas auxiliares | Suporte a módulos existentes e novos | Exportação avançada de relatórios, dashboards customizáveis, notificações em tempo real |
-
----
-
-## 8. Instalação
-
-```bash
-# Clonar o repositório
-git clone https://github.com/ErickG123/devkit_forense.git
-cd devkit-forense
-
-# Criar ambiente virtual
-python -m venv venv
-source venv/bin/activate  # Linux/macOS
-venv\Scripts\activate    # Windows
-
-# Instalar dependências
-pip install -r requirements.txt
-```
-
----
-
-## 9. Exemplos de Execução
-
-**CLI:**
-```bash
-# Executar módulo de network scan
-python cli.py network_map --target 192.168.0.0/24
-
-# Coletar histórico do Chrome
-python cli.py browser_history --browser chrome
-```
-
-**API:**
-```bash
-# Executar API
-uvicorn api.main:app --reload
-```
-
----
-
-## 10. Considerações Finais
-
-O DevKit Forense combina **educação e prática**, permitindo que usuários explorem análise forense digital de forma segura, didática e interativa.  
-As aplicações de apoio aumentam a acessibilidade e engajamento, tornando o estudo da perícia digital mais visual e intuitivo.  
-O planejamento de novos módulos e ferramentas garante evolução contínua da plataforma, mantendo-a atualizada e relevante para atividades acadêmicas e laboratoriais.

forensic_cli-1.2.6/src/core/network/arp_scan.py

@@ -1,16 +0,0 @@
-from scapy.all import ARP, Ether, srp
-import typer
-
-def arp_scan(network_ips):
-    active_hosts = []
-
-    typer.echo(f"[+] Iniciando ARP scan ({len(network_ips)} IPs)...")
-    with typer.progressbar(network_ips, label="ARP Scan") as progress:
-        for ip in network_ips:
-            pkt = Ether(dst="ff:ff:ff:ff:ff:ff") / ARP(pdst=ip)
-            ans, _ = srp(pkt, timeout=1, verbose=0)
-            if ans:
-                active_hosts.append(ip)
-            progress.update(1)
-
-    return active_hosts