# Nebula – AI-Powered Penetration Testing Assistant
Nebula is an advanced, AI-powered penetration testing open-source tool that revolutionizes penetration testing by integrating state-of-the-art AI models into your command-line interface. Designed for cybersecurity professionals, ethical hackers, and developers, Nebula automates vulnerability assessments and enhances security workflows with real-time insights and automated note-taking.
## Acknowledgement
**First i would like to thank the All-Mighty God who is the source of all knowledge, without Him, this would not be possible.**
## News
Introducing the Deep Application Profiler (DAP). DAP uses neural networks to analyze an executable's internal structure and intent, rather than relying on traditional virus signatures. This approach enables it to detect new, zero-day malware that conventional methods often miss. DAP also provides detailed breakdowns for rapid analyst review and is available as both a web service and an API. [Learn More Here](https://www.berylliumsec.com/dap-overview)
Introducing Nebula Pro, Nebula Pro improves on Nebula 2.0 by adding additional features such as autonomous mode, code analysis and more. [Learn More Here](https://www.berylliumsec.com/nebula-pro-overview)
## Nebula: AI-Powered Penetration Testing Platform
Nebula is a cutting-edge, AI-powered penetration testing tool designed for cybersecurity professionals and ethical hackers. It integrates advanced open-source AI models such as Meta's Llama-3.1-8B-Instruct, Mistralai's Mistral-7B-Instruct-v0.2, and DeepSeek-R1-Distill-Llama-8B—directly into the command line interface (CLI). By leveraging these state-of-the-art models, Nebula not only enhances vulnerability assessments and penetration testing workflows but also supports any tool that can be invoked from the CLI.
## Installation
**System Requirements:**
- At least 8GB of GPU memory (tested with 12GB)
- Python 3.11 or higher
**Installation Command:**
```bash
python -m pip install nebula-ai --upgrade
```
## Running Nebula
**Important:**
On your first run, you’ll be prompted to select a cache directory where Nebula will download your chosen AI model. Follow these steps:
1. Create a free [Hugging Face Account](https://huggingface.co/), agree to the terms, and generate an access token.
2. Export your token to the CLI:
```bash
export HF_TOKEN=YourTokenHere
```
3. Launch Nebula and monitor the download progress on the CLI.
```bash
nebula
```
This step only needs to be completed once. Monitor the command line interface where you invoked `nebula` from to monitor the download progress.
### Interacting with the models.
To interact with the models, begin your input with a `!` for example: `! write a python script to scan the ports of a remote system`
## Key Features
- **AI-Powered Internet Search:**
Enhance responses by integrating real-time, internet-sourced context to keep you updated on cybersecurity trends.
- **AI-Assisted Note-Taking:**
Automatically record and categorize security findings.
- **Real-Time AI-Driven Insights:**
Get immediate suggestions for discovering and exploiting vulnerabilities based on terminal tool outputs.
- **Enhanced Tool Integration:**
Seamlessly import data from external tools for AI-powered note-taking and advice.
- **Integrated Screenshot & Editing:**
Capture and annotate images directly within Nebula for streamlined documentation.
- **Manual Note-Taking & Automatic Command Logging:**
Maintain a detailed log of your actions and findings with both automated and manual note-taking features.
## Getting Started
For a comprehensive video guide visit [here](https://www.berylliumsec.com/nebula-pro-feature-guide) and [here](https://www.youtube.com/playlist?list=PLySxaLbLL0gpAaDQYq6g6sb1q6KwqOAr4). Please note that some features are only applicable to Nebula Pro.You can also access the help screen within Nebula or refer to the [Manual.md](/MANUAL.md) document
### Roadmap
- Support more models
- Add agents
### Troubleshooting
Logs are located at `/home/[your_username]/.local/share/nebula/logs`. You would most likely find the reason for the error in one of those logs
## Get More Support
- Have questions or need help? [Open an Issue](https://github.com/berylliumsec/nebula/issues) on GitHub.
- For comprehensive guides, check out our [Video Guide](https://www.berylliumsec.com/nebula-pro-feature-guide) and [User Manual](/MANUAL.md).
Raw data
{
"_id": null,
"home_page": null,
"name": "nebula-ai",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>=3.11",
"maintainer_email": null,
"keywords": "AI, ethical hacking, nmap, zap, crackmapexec",
"author": "David I",
"author_email": "david@berylliumsec.com",
"download_url": "https://files.pythonhosted.org/packages/a6/42/1b395cb5392f0c4b9eb6f8fcfd3eb28577d0871de323ce0702ae003a9537/nebula_ai-2.0.0b8.tar.gz",
"platform": null,
"description": "# Nebula \u2013 AI-Powered Penetration Testing Assistant\n\nNebula is an advanced, AI-powered penetration testing open-source tool that revolutionizes penetration testing by integrating state-of-the-art AI models into your command-line interface. Designed for cybersecurity professionals, ethical hackers, and developers, Nebula automates vulnerability assessments and enhances security workflows with real-time insights and automated note-taking.\n\n\n\n\n## Acknowledgement\n\n**First i would like to thank the All-Mighty God who is the source of all knowledge, without Him, this would not be possible.**\n\n## News\n\nIntroducing the Deep Application Profiler (DAP). DAP uses neural networks to analyze an executable's internal structure and intent, rather than relying on traditional virus signatures. This approach enables it to detect new, zero-day malware that conventional methods often miss. DAP also provides detailed breakdowns for rapid analyst review and is available as both a web service and an API. [Learn More Here](https://www.berylliumsec.com/dap-overview)\n\n\nIntroducing Nebula Pro, Nebula Pro improves on Nebula 2.0 by adding additional features such as autonomous mode, code analysis and more. [Learn More Here](https://www.berylliumsec.com/nebula-pro-overview)\n\n## Nebula: AI-Powered Penetration Testing Platform\n\nNebula is a cutting-edge, AI-powered penetration testing tool designed for cybersecurity professionals and ethical hackers. It integrates advanced open-source AI models such as Meta's Llama-3.1-8B-Instruct, Mistralai's Mistral-7B-Instruct-v0.2, and DeepSeek-R1-Distill-Llama-8B\u2014directly into the command line interface (CLI). By leveraging these state-of-the-art models, Nebula not only enhances vulnerability assessments and penetration testing workflows but also supports any tool that can be invoked from the CLI.\n\n\n## Installation\n\n**System Requirements:**\n- At least 8GB of GPU memory (tested with 12GB)\n- Python 3.11 or higher\n\n**Installation Command:**\n```bash\npython -m pip install nebula-ai --upgrade\n```\n\n\n## Running Nebula\n\n**Important:** \n\nOn your first run, you\u2019ll be prompted to select a cache directory where Nebula will download your chosen AI model. Follow these steps:\n\n1. Create a free [Hugging Face Account](https://huggingface.co/), agree to the terms, and generate an access token.\n2. Export your token to the CLI:\n ```bash\n export HF_TOKEN=YourTokenHere\n ```\n3. Launch Nebula and monitor the download progress on the CLI.\n\n ```bash\n nebula\n ```\n\nThis step only needs to be completed once. Monitor the command line interface where you invoked `nebula` from to monitor the download progress.\n\n### Interacting with the models. \n\nTo interact with the models, begin your input with a `!` for example: `! write a python script to scan the ports of a remote system`\n\n## Key Features\n\n- **AI-Powered Internet Search:** \n Enhance responses by integrating real-time, internet-sourced context to keep you updated on cybersecurity trends.\n\n- **AI-Assisted Note-Taking:** \n Automatically record and categorize security findings.\n\n- **Real-Time AI-Driven Insights:** \n Get immediate suggestions for discovering and exploiting vulnerabilities based on terminal tool outputs.\n\n- **Enhanced Tool Integration:** \n Seamlessly import data from external tools for AI-powered note-taking and advice.\n\n- **Integrated Screenshot & Editing:** \n Capture and annotate images directly within Nebula for streamlined documentation.\n\n- **Manual Note-Taking & Automatic Command Logging:** \n Maintain a detailed log of your actions and findings with both automated and manual note-taking features.\n\n\n## Getting Started\n\nFor a comprehensive video guide visit [here](https://www.berylliumsec.com/nebula-pro-feature-guide) and [here](https://www.youtube.com/playlist?list=PLySxaLbLL0gpAaDQYq6g6sb1q6KwqOAr4). Please note that some features are only applicable to Nebula Pro.You can also access the help screen within Nebula or refer to the [Manual.md](/MANUAL.md) document\n\n### Roadmap\n\n- Support more models\n- Add agents\n\n### Troubleshooting\n\nLogs are located at `/home/[your_username]/.local/share/nebula/logs`. You would most likely find the reason for the error in one of those logs\n\n## Get More Support\n\n- Have questions or need help? [Open an Issue](https://github.com/berylliumsec/nebula/issues) on GitHub.\n- For comprehensive guides, check out our [Video Guide](https://www.berylliumsec.com/nebula-pro-feature-guide) and [User Manual](/MANUAL.md).\n\n\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "AI-Powered Ethical Hacking Assistant",
"version": "2.0.0b8",
"project_urls": {
"Homepage": "https://github.com/berylliumsec/nebula"
},
"split_keywords": [
"ai",
" ethical hacking",
" nmap",
" zap",
" crackmapexec"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "2bbd889ec9e10298c31b1afe5540e253b5e492cb50b76a7896f0dc46970531e4",
"md5": "1a9ce24dabaee427120bccf4275a5082",
"sha256": "f6c434bf7c6f5c73946366b3b42d4c895cd589686db65b4c2b1cbef1478d05ed"
},
"downloads": -1,
"filename": "nebula_ai-2.0.0b8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1a9ce24dabaee427120bccf4275a5082",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.11",
"size": 20832139,
"upload_time": "2025-02-19T00:06:48",
"upload_time_iso_8601": "2025-02-19T00:06:48.152043Z",
"url": "https://files.pythonhosted.org/packages/2b/bd/889ec9e10298c31b1afe5540e253b5e492cb50b76a7896f0dc46970531e4/nebula_ai-2.0.0b8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a6421b395cb5392f0c4b9eb6f8fcfd3eb28577d0871de323ce0702ae003a9537",
"md5": "7b2abea3645407d2f6849419a961ca2c",
"sha256": "130cd8e591da728df08cafa9141d1a69ef7a5c79fa26033e45396586883fcee4"
},
"downloads": -1,
"filename": "nebula_ai-2.0.0b8.tar.gz",
"has_sig": false,
"md5_digest": "7b2abea3645407d2f6849419a961ca2c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.11",
"size": 20714782,
"upload_time": "2025-02-19T00:06:52",
"upload_time_iso_8601": "2025-02-19T00:06:52.797529Z",
"url": "https://files.pythonhosted.org/packages/a6/42/1b395cb5392f0c4b9eb6f8fcfd3eb28577d0871de323ce0702ae003a9537/nebula_ai-2.0.0b8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-19 00:06:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "berylliumsec",
"github_project": "nebula",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nebula-ai"
}
JSON
