Skip to content

Latest commit

ย 

History

124 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

BUIT Banner

๐Ÿ” BUIT - Buu Undercover Intelligence Toolkit

A blazingly fast OSINT framework built with Rust

Made with Rust Made with โค๏ธ GitHub release License: MIT

Downloads Stars Forks

๐Ÿ“ฅ Download โ€ข ๐Ÿ“– Documentation โ€ข ๐Ÿš€ Get Started โ€ข ๐Ÿ’ฌ Community


โœจ What is BUIT?

BUIT is a comprehensive Open Source Intelligence (OSINT) toolkit designed for security professionals, researchers, and ethical hackers. Combine 25+ reconnaissance modules into a single, lightning-fast command-line tool with enhanced IP analysis and complete API results.

๐Ÿš€ Quick Install

Choose your platform:

Windows macOS
Linux

๐ŸชŸ Windows

# Download latest v1.0.4 release
# For Windows x64:
Expand-Archive buit-v1.0.4-windows-x64.zip
.\buit-windows-x64.exe --help

# For Windows x86:
Expand-Archive buit-v1.0.4-windows-x86.zip
.\buit-windows-x86.exe --help

๐ŸŽ macOS

# Intel Mac (x64)
curl -L https://github.com/BuuDevOff/BUIT/releases/download/v1.0.4/buit-v1.0.4-macos-x64.tar.gz | tar -xz
./buit-macos-x64 --help

# Apple Silicon (ARM64)
curl -L https://github.com/BuuDevOff/BUIT/releases/download/v1.0.4/buit-v1.0.4-macos-arm64.tar.gz | tar -xz
./buit-macos-arm64 --help

๐Ÿง Linux

# Linux x64
curl -L https://github.com/BuuDevOff/BUIT/releases/download/v1.0.4/buit-v1.0.4-linux-x64.tar.gz | tar -xz
./buit-linux-x64 --help

# Linux ARM64
curl -L https://github.com/BuuDevOff/BUIT/releases/download/v1.0.4/buit-v1.0.4-linux-arm64.tar.gz | tar -xz
./buit-linux-arm64 --help

๐ŸŒ Global Installation (Recommended)

After downloading any version above, make BUIT available system-wide:

# ๐Ÿš€ Auto-setup: Adds BUIT to your PATH automatically
./buit setup

# โœ… Now use 'buit' from anywhere in your terminal!
buit --help
buit ip 8.8.8.8

What the setup command does:

  • ๐Ÿ”ง Windows: Adds BUIT to %PATH% environment variable
  • ๐ŸŽ macOS: Creates symlink in /usr/local/bin/ or adds to ~/.bashrc
  • ๐Ÿง Linux: Creates symlink in /usr/local/bin/ or adds to ~/.bashrc
  • ๐Ÿ”„ Automatic: Detects your system and configures appropriately

๐Ÿ› ๏ธ Build from Source

# Install Rust if needed
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Clone and build
git clone https://github.com/BuuDevOff/BUIT.git && cd BUIT
cargo build --release

# Install globally
./target/release/buit setup

โšก Quick Start

๐Ÿ’ก Pro tip: Run ./buit setup first to install globally, then use buit from anywhere!

๐ŸŽฏ Common OSINT Tasks
# ๐Ÿ” Username reconnaissance
buit username john_doe

# ๐Ÿ“ง Email intelligence gathering
buit email target@example.com --breaches --social

# ๐ŸŒ Domain reconnaissance
buit domain example.com --dns --ssl --whois

# ๐Ÿ“ฑ Phone number lookup
buit phone +1234567890 --carrier

# ๐Ÿ” Hash analysis
buit hash 5d41402abc4b2a76b9719d911017c592 --identify
๐Ÿ” Advanced Reconnaissance
# ๐Ÿ•ท๏ธ Subdomain enumeration
buit subdomain example.com --crt --brute

# ๐ŸŒ Complete IP analysis (now with full details by default!)
buit ip 8.8.8.8

# ๐ŸŒ Website technology stack
buit urlscan https://example.com --screenshot

# ๐Ÿ“š Wayback Machine lookup
buit wayback https://example.com --year 2020

๐Ÿ’ก Pro tip: Use buit <module> --help for detailed options on any module!

๐Ÿš€ NEW in v1.0.4 - Enhanced API Server
# ๐ŸŒ Start API server with complete results
buit --api --port 3000

# ๐Ÿ” Get real IP analysis data (not just success messages!)
curl "http://localhost:3000/ip/8.8.8.8"
# Returns: {"success": true, "data": {"ip": "8.8.8.8", "reverse_dns": "dns.google", "asn": {"number": "AS15169", "organization": "Google LLC"}, ...}}

# ๐Ÿ“Š All modules now return actual analysis results via API
curl "http://localhost:3000/domain/example.com"
curl "http://localhost:3000/email/test@example.com"

What's New:

  • โœ… Complete Results: APIs now return actual analysis data instead of generic messages
  • โœ… Enhanced IP Analysis: Full geolocation, ASN, and reverse DNS by default
  • โœ… Better Accuracy: Multiple API fallbacks for reliable data sources
  • โœ… Structured Data: JSON responses with all details for integration

๐Ÿ”ง Available Modules

๐Ÿ” Reconnaissance ๐ŸŒ Web Intelligence ๐Ÿ“ฑ Social & Communications
username - Social media username search domain - Comprehensive domain analysis email - Email breach & social lookup
ip - IP geolocation & ASN analysis urlscan - URL technology scanning phone - Phone number investigation
subdomain - Subdomain enumeration wayback - Wayback Machine queries social - Social media reconnaissance
github - GitHub profile analysis search - Multi-engine searches leaks - Data breach detection
๐Ÿ›ก๏ธ Security & Analysis ๐Ÿ“Š Data & Reporting โšก Interactive Tools
portscan - Port discovery metadata - File metadata extraction interactive - Guided workflows
hash - Hash identification & cracking report - Generate findings reports config - Configuration management
whois - Domain registration lookup reverse-image - Image reverse search setup - Installation assistant
shodan - Device intelligence dork - Google dorking -

โš™๏ธ Configuration

๐Ÿ”ง Performance Tuning
# ๐Ÿš€ Boost scanning speed with more threads
buit config set-threads 20

# ๐ŸŒ Route through proxy for anonymity
buit config set-proxy http://127.0.0.1:8080

# ๐Ÿ” Change user agent for better compatibility
buit config set-user-agent chrome
๐Ÿ”‘ API Keys & Integrations
# ๐Ÿ›ก๏ธ Shodan API for device intelligence
buit config set-key shodan YOUR_SHODAN_API_KEY

# ๐Ÿ™ GitHub API for enhanced repository analysis
buit config set-key github YOUR_GITHUB_TOKEN

# ๐Ÿ“ง Hunter.io for email intelligence
buit config set-key hunter YOUR_HUNTER_API_KEY
# ๐Ÿ“‹ View current configuration
buit config list

๐ŸŒŸ Why Choose BUIT?

๐Ÿš€ Performance ๐Ÿ›ก๏ธ Reliability ๐Ÿ”ง Flexibility
โšก Blazing Fast - Rust-powered for maximum speed ๐Ÿ”’ Robust - Enterprise-grade error handling ๐ŸŽฏ 25+ Modules - Complete OSINT toolkit
๐Ÿ”„ Multi-threaded - Parallel processing capabilities ๐Ÿ› ๏ธ Fallback Systems - Never leaves you hanging โš™๏ธ Configurable - Adapt to your workflow
๐Ÿ“Š Optimized - Memory efficient and resource-aware ๐Ÿ” Tested - Battle-tested in real scenarios ๐ŸŒ Cross-platform - Windows, macOS, Linux

๐Ÿค Contributing

Help make BUIT even better!

GitHub Issues Pull Requests

๐Ÿ”ง Add New Modules

Got an innovative OSINT technique? We want to see it!

# Check existing module structure
ls src/modules/

# Follow the established patterns
# - Async/await support
# - Error handling with anyhow::Result
# - Configurable output formats
# - Built-in help documentation
๐Ÿ› Report Issues & Request Features
  • ๐Ÿ› Found a bug? Open an issue with reproduction steps
  • ๐Ÿ’ก Feature idea? Share your vision for new capabilities
  • ๐Ÿ“– Documentation? Help improve our guides and examples
  • ๐Ÿงช Testing? Help us test across different platforms
๐ŸŒŸ Spread the Word

Love BUIT? Help the community grow:

  • โญ Star this repository - Show your support
  • ๐Ÿ”„ Share with colleagues - Security professionals unite!
  • ๐Ÿ“ข Social media mentions - Tweet, post, discuss
  • ๐Ÿ’ฌ Community forums - Share in security communities

Every star, share, and mention helps BUIT reach more security professionals!

โš–๏ธ Legal Notice

๐Ÿ›ก๏ธ Ethical Use Only

This tool is designed for authorized security testing and educational purposes only.

Always ensure proper authorization before conducting reconnaissance activities.

The developers assume no responsibility for misuse of this software.

๐Ÿ†• What's New in v1.0.4

๐Ÿ”ฅ Major Enhancements - Enhanced IP Analysis & Complete API Results

๐ŸŒ Enhanced IP Analysis

Complete Analysis by Default:

# Before v1.0.4: Required manual flags
buit ip 8.8.8.8 --reverse --asn --geo

# v1.0.4+: Everything enabled by default!  
buit ip 8.8.8.8

# ๐ŸŒ After 'buit setup' - use from anywhere:
buit ip 1.1.1.1
# Output: Complete analysis with ASN "AS13335 Cloudflare Inc., US"

New Features:

  • โœ… Auto-enabled: Reverse DNS, ASN, and geolocation data shown automatically
  • โœ… Accurate ISP Detection: Multiple API fallbacks (hackertarget.com โ†’ ipinfo.io โ†’ ipapi.co)
  • โœ… Better Data Quality: Fixed ASN parsing with correct CSV format handling
  • โœ… Real-time Accuracy: No more demo/fake data when APIs fail
๐Ÿš€ Complete API Results

Before v1.0.4:

{
  "success": true,
  "data": {
    "ip": "8.8.8.8",
    "message": "IP analysis completed successfully",
    "note": "Detailed results available via CLI"
  }
}

v1.0.4+ Returns Real Data:

{
  "success": true,
  "data": {
    "ip": "8.8.8.8",
    "valid": true,
    "version": "IPv4",
    "reverse_dns": "dns.google",
    "asn": {
      "number": "AS15169",
      "organization": "Google LLC",
      "country": "US"
    },
    "geolocation": {
      "country": "United States",
      "city": "Mountain View",
      "region": "California",
      "latitude": 37.4056,
      "longitude": -122.0785
    }
  }
}

Benefits:

  • ๐ŸŽฏ Integration-Ready: Use API responses directly in your applications
  • ๐Ÿ“Š Complete Data: All analysis results available via REST API
  • ๐Ÿ”„ Consistent Format: Structured JSON responses across all modules
  • โšก No More Console Scraping: Direct programmatic access to results

๐Ÿš€ Roadmap - Coming Soon

๐ŸŽฏ v1.1.0 - Discord Intelligence Module
  • ๐ŸŽฎ discord - Advanced Discord OSINT capabilities
    • ๐Ÿ” User profile analysis via Discord ID
    • ๐Ÿฐ Server/guild information gathering
    • ๐Ÿค– Direct Discord API integration
    • ๐Ÿ–ผ๏ธ Avatar/banner analysis (animated support)
    • ๐Ÿ… Badge detection (Staff, Partner, Bug Hunter, etc.)
    • โฐ Account creation timestamp extraction
    • ๐Ÿ•ธ๏ธ Relationship mapping and connections
    • ๐Ÿ“Š Enhanced data vs third-party services
    • โšก Multi-token support for rate limits
    • ๐Ÿ“š Comprehensive setup documentation

๐ŸŽฌ Demo Videos

Username Search Demo

Username Demo

Subdomain Enumeration Demo

Subdomain Demo

๐Ÿ“„ License

License: MIT

MIT License - see the LICENSE file for details


Built with โค๏ธ by BuuDevOff

Made with Rust Open Source

About

Fast OSINT toolkit written in Rust for security researchers. 25+ modules for reconnaissance, subdomain enumeration, social media research & more.

Resources

Contributing

Stars

48 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages