🚧 Status: Under Development 🚧
Cygnus is a powerful and intuitive web application framework designed to streamline and automate the process of web reconnaissance. It provides a comprehensive suite of tools for both active and passive information gathering, all accessible through a clean, modern web interface.
This project aims to centralize common recon tasks, making it an essential tool for security professionals, penetration testers, and bug bounty hunters.
In the initial phase of any security assessment, reconnaissance is critical. Gathering information about a target can be a time-consuming process, often involving multiple disparate tools.
Cygnus was created to solve this problem by integrating a variety of recon tasks into a single, cohesive platform.
Key highlights:
- Robust backend with asynchronous task handling.
- Reactive frontend for a smooth user experience.
- Seamless task management, ensuring long-running scans (e.g., directory bruteforcing, port scanning) don’t block the UI.
- WHOIS Lookup → Retrieve domain registration data.
- DNS Lookup → Query A, MX, TXT, and other DNS records.
- Certificate Lookup → Inspect SSL/TLS certificates and transparency logs.
- Shodan Enumeration → Integrate with Shodan API for exposed devices & services.
- Port Scanning → Identify open ports on target hosts.
- Directory Bruteforcing → Discover hidden files & directories.
- Subdomain Finding → Enumerate subdomains of a target domain.
- Backend: Django, Django REST Framework
- Frontend: React.js
- Database: PostgreSQL
- Asynchronous Tasks: Celery
- Message Broker: Redis
Follow these steps to set up a local development environment.
Ensure you have installed:
- Python 3.8+
- Node.js & npm
- PostgreSQL
- Redis
Clone the repository:
git clone https://github.com/your-username/cygnus.git
cd cygnus
# Create and activate virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Configure environment variables
cp .env.example .env
# Run migrations
python manage.py migrate
# frontend
cd frontend
npm install
# Backend
python manage.py runserver
# Frontend
cd frontend
npm start
# Redis
redis-server
# Celery worker
celery -A cygnus worker -l info🖥️ Usage
Once running, open your browser at http://localhost:3000 From the dashboard you can: Select a target. Launch active/passive reconnaissance tasks. View results in real-time as scans complete. (Detailed usage instructions & screenshots will be added as the project matures.)
🗺️ Roadmap Implement user authentication & multi-user support. Add project/target management system. Generate reports (PDF, CSV). Integrate APIs like VirusTotal, Hunter.io. Visual dashboards with charts & graphs. Dockerize for streamlined deployment.
👉 See open issues for full list of proposed features & bugs.
🙌 Contributing Contributions make the community amazing! Any help is greatly appreciated. Fork the repo
Create a feature branch
Create a feature branch
git checkout -b feature/AmazingFeature
Commit your changes
git commit -m 'Add AmazingFeature'
Push the branch
git push origin feature/AmazingFeature
Open a Pull Request📄 License Distributed under the MIT License. See LICENSE for details.