CoolFace
Apppublic

S-Dreamer/DarkOSint

sourceHugging Faceapache-2.0updated 5mo agoView on Hugging Face
4likes
App README

Core Features

Threat Intelligence Dashboard

  • —Real-time dark web monitoring workflows
  • —Threat feed aggregation and analysis
  • —Indicator of Compromise (IOC) tracking
  • —Risk scoring and prioritization
  • —Threat activity timeline visualization

OSINT Correlation

DarkOSint integrates passive intelligence sources to enrich indicators and improve analytical context. Supported workflows include:

  • —VirusTotal correlation
  • —AlienVault OTX enrichment
  • —Passive DNS analysis
  • —Hash reputation verification
  • —Domain and infrastructure profiling

Alerting & Monitoring

  • —Configurable alert pipelines
  • —Threat severity classification
  • —Custom intelligence watchlists
  • —Notification workflows
  • —Historical event tracking

Reporting & Analytics

  • —Analyst-ready reporting
  • —Exportable findings packages
  • —IOC summaries
  • —Threat trend visualization
  • —Evidence management workflows ---

Security Architecture

DarkOSint follows a defensive-first security model designed to support authorized cybersecurity operations.

Authentication & Access Control

  • —JWT-based authentication
  • —API key management
  • —Role-based access controls (RBAC)
  • —Session validation mechanisms
  • —Rate limiting protections

Data Privacy & Evidence Handling

  • —PII detection and masking
  • —Secure logging practices
  • —Sanitized evidence handling
  • —Audit-aware operational workflows

Defensive Scope Constraints

The platform is intended for:

  • —Authorized security operations
  • —Threat intelligence analysis
  • —Detection engineering workflows
  • —Defensive security research
  • —Incident investigation support The platform is not intended for:
  • —Unauthorized system access
  • —Credential abuse
  • —Malware deployment
  • —Persistence mechanisms
  • —Destructive or disruptive operations ---

Technical Stack

LayerTechnology
FrontendStreamlit
BackendFastAPI
DatabasePostgreSQL
ORMSQLAlchemy
Async SupportAsync PostgreSQL
SecurityJWT / RBAC
Intelligence SourcesVirusTotal / AlienVault OTX
NetworkingTor proxy support

Project Structure

text
DarkOSint/
├── app.py
├── requirements.txt
├── README.md
├── src/
│   ├── api/
│   ├── core/
│   ├── intelligence/
│   ├── monitoring/
│   ├── reporting/
│   └── security/
├── assets/
├── exports/
├── tests/
└── docs/

⸻

Installation

Clone Repository

git clone https://github.com/yourusername/darkosint.git cd darkosint

Create Virtual Environment

python -m venv .venv

Activate Environment

Linux / macOS

source .venv/bin/activate

Windows PowerShell

.venv\Scripts\Activate.ps1

Install Dependencies

pip install --upgrade pip pip install -r requirements.txt

⸻

Running DarkOSint

Launch Streamlit Frontend

streamlit run app.py

Launch FastAPI Backend

uvicorn src.api.main:app --reload

⸻

Environment Variables

Create a .env configuration file:

DATABASEURL=postgresql://user:password@localhost/darkosint JWTSECRET=changeme VTAPIKEY=yourvirustotalkey OTXAPIKEY=yourotxkey TORPROXY=socks5://127.0.0.1:9050

⸻

Example Workflows

IOC Enrichment Workflow

  1. 1.Submit an IP address, domain, hash, or URL
  2. 2.Correlate indicators across OSINT providers
  3. 3.Score and classify indicators
  4. 4.Export analytical findings

Threat Monitoring Workflow

  1. 1.Configure intelligence watchlists
  2. 2.Monitor external intelligence feeds
  3. 3.Trigger alerts on relevant matches
  4. 4.Review findings through analyst dashboards

Reporting Workflow

  1. 1.Aggregate evidence and indicators
  2. 2.Generate structured summaries
  3. 3.Export findings packages
  4. 4.Archive investigation records

⸻

Defensive Use Policy

DarkOSint is intended exclusively for:

  • —Defensive cybersecurity operations
  • —Threat intelligence analysis
  • —Authorized investigations
  • —Detection engineering
  • —Blue team and purple team workflows

Users are responsible for ensuring compliance with applicable laws, organizational policies, and authorization boundaries.

⸻

Future Roadmap

Planned capabilities include:

  • —SIEM integrations
  • —Sigma rule generation
  • —MITRE ATT&CK mapping
  • —Automated IOC clustering
  • —Graph-based relationship visualization
  • —Threat actor tracking
  • —Case management workflows
  • —Multi-user collaboration

⸻

License

Licensed under the Apache 2.0 License.

⸻

Contributing

Contributions are welcome in areas including:

  • —Detection engineering
  • —Threat intelligence integrations
  • —Dashboard UX improvements
  • —Data enrichment pipelines
  • —Reporting enhancements
  • —Performance optimization

⸻

Disclaimer

DarkOSint is provided for authorized and defensive cybersecurity operations only.

The maintainers assume no responsibility for misuse, unauthorized deployment, or operational damage resulting from modification or use of this software.