{"id":48289796,"url":"https://github.com/yashab-cyber/neo","last_synced_at":"2026-04-04T23:02:41.944Z","repository":{"id":302094870,"uuid":"1010842189","full_name":"yashab-cyber/neo","owner":"yashab-cyber","description":"The Next-Generation AI Assistant for Complete Digital Transformation  NEO (Neural Executive Operator) is an advanced artificial intelligence assistant designed to revolutionize how you interact with technology. Combining deep learning, neuro learning, recursive learning, and smart thinking capabilities, NEO serves as your ultimate digital agent .","archived":false,"fork":false,"pushed_at":"2025-08-10T12:08:53.000Z","size":608,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-10T12:27:19.533Z","etag":null,"topics":["ai","artificial-intelligence","artificial-neural-networks","cybersecurity"],"latest_commit_sha":null,"homepage":"https://www.zehrasec.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yashab-cyber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-29T22:55:19.000Z","updated_at":"2025-08-10T12:12:26.000Z","dependencies_parsed_at":"2025-06-30T15:22:15.399Z","dependency_job_id":"802d0580-0e03-4c27-bc1b-4604476bdd9e","html_url":"https://github.com/yashab-cyber/neo","commit_stats":null,"previous_names":["yashab-cyber/neo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yashab-cyber/neo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fneo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fneo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fneo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fneo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yashab-cyber","download_url":"https://codeload.github.com/yashab-cyber/neo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fneo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31418287,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","artificial-intelligence","artificial-neural-networks","cybersecurity"],"created_at":"2026-04-04T23:02:11.326Z","updated_at":"2026-04-04T23:02:41.922Z","avatar_url":"https://github.com/yashab-cyber.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🔹 NEO: Neural Executive Operator\n\n**The Next-Generation AI Assistant for Complete Digital Transformation**\n\nNEO (Neural Executive Operator) is an advanced artificial intelligence assistant designed to revolutionize how you interact with technology. Combining deep learning, neuro learning, recursive learning, and smart thinking capabilities, NEO serves as your ultimate digital agent for handling complex tasks, automations, and intelligent decision-making.\n\n[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n[![Version](https://img.shields.io/badge/version-1.0.0-orange.svg)](CHANGELOG.md)\n\n## 🚀 Key Features\n\n- **� Google Gemini AI Integration**: State-of-the-art AI powered by Google's Gemini models\n- **�🧠 Advanced Learning Systems**: Deep learning, neuro learning, and recursive learning capabilities\n- **🎯 Smart Problem Solving**: Tackles complex problems across mathematics, science, and any subject domain\n- **🖥️ Complete PC Control**: Full system automation including shutdown, startup, and complex operations\n- **🔒 Cybersecurity Expert**: Advanced penetration testing, security analysis, and threat detection\n- **💻 Coding Assistant**: Complete development support with debugging, optimization, and best practices\n- **🔬 Research \u0026 Development**: Intelligent research capabilities with optimized output generation\n- **⚡ Task Automation**: Efficient command execution and decision-making processes\n- **💬 Natural Conversations**: Context-aware chat with multi-language support\n\n## 📋 Table of Contents\n\n- [Quick Start](#quick-start)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Features](#features)\n- [Architecture](#architecture)\n- [Configuration](#configuration)\n- [Development](#development)\n- [Documentation](#documentation)\n- [Contributing](#contributing)\n- [License](#license)\n\n## ⚡ Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/neo.git\ncd neo\n\n# Install NEO\nchmod +x scripts/install.sh\n./scripts/install.sh\n\n# Activate environment\nsource venv/bin/activate\n\n# Run NEO\npython -m src.main --mode interactive\n```\n\n## 🔧 Installation\n\n### Prerequisites\n\n- Python 3.8 or higher\n- pip package manager\n- Git\n\n### Option 1: Installation Script (Recommended)\n\n```bash\nchmod +x scripts/install.sh\n./scripts/install.sh\nsource venv/bin/activate\n```\n\n### Option 2: Manual Installation\n\n```bash\n# Create virtual environment\npython3 -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n\n# Install dependencies\npip install -r requirements.txt\n\n# Install NEO\npip install -e .\n```\n\n### Option 3: Docker\n\n```bash\n# Build and run with Docker Compose\ndocker-compose up -d\n\n# Access NEO\ndocker exec -it neo-assistant python -m src.main\n```\n\n### 🤖 Gemini AI Setup (Optional but Recommended)\n\nTo enable advanced AI features powered by Google Gemini:\n\n```bash\n# Run the setup script\n./scripts/setup_gemini.sh\n\n# Or manually:\n# 1. Install the package\npip install google-generativeai\n\n# 2. Get your API key from https://makersuite.google.com/app/apikey\n\n# 3. Add to .env file\necho \"GEMINI_API_KEY=your_api_key_here\" \u003e\u003e .env\n```\n\nFor detailed Gemini setup and usage, see [Gemini Integration Guide](docs/GEMINI_GUIDE.md).\n\n## 💡 Usage\n\n### Interactive Mode\n\nStart NEO in interactive mode for conversational interaction:\n\n```bash\nneo\n# or\npython -m src.main --mode interactive\n```\n\n**Example Session:**\n```\nYou: Hello NEO\nNEO: Hello! I'm NEO, your Neural Executive Operator. How can I assist you today?\n\nYou: Show me system information\nNEO: System: Linux 5.15.0, CPU: 25.3%, Memory: 45.2%\n\nYou: /ai Explain quantum computing\nNEO: Quantum computing leverages quantum mechanics principles...\n\nYou: /code def factorial(n): return n * factorial(n-1) if n \u003e 0 else 1\nNEO: Code Analysis: Quality Score: 85/100. Suggestions: Add base case check, use memoization...\n```\n\n**Special Gemini Commands:**\n- `/ai \u003cquery\u003e` - Direct AI conversation\n- `/code \u003ccode\u003e` - AI-powered code analysis\n- `/solve \u003cproblem\u003e` - Problem solving with reasoning\n- `/summarize \u003ctext\u003e` - Summarize long text\n- `/translate \u003clang\u003e \u003ctext\u003e` - Translate to any language\n- `/help` - Show all commands\n\n### Command Mode\n\nExecute single commands:\n\n```bash\nneo --mode command --command \"Show system information\"\n```\n\n### Custom Configuration\n\n```bash\nneo --config config/neo_config.yaml\n```\n\n## 🎯 Features\n\n### 1. AI Engine\n\nAdvanced AI capabilities powered by multiple learning systems:\n\n- **Deep Learning**: Neural network-based processing\n- **Neuro Learning**: Pattern recognition and adaptation\n- **Recursive Learning**: Iterative problem solving\n- **Smart Thinking**: Intelligent decision making\n\n```python\nfrom src.core.ai_engine import NEOAIEngine\n\nengine = NEOAIEngine()\nresult = engine.process_task({\n    'type': 'analysis',\n    'description': 'Analyze data',\n    'data': your_data\n})\n```\n\n### 2. System Control\n\nComplete system automation and monitoring:\n\n- System information retrieval\n- Process management\n- Resource monitoring\n- Task scheduling\n- Safe command execution\n\n**Commands:**\n```\nsystem info\nshow processes\nmonitor cpu\nmonitor memory\n```\n\n### 3. Cybersecurity\n\nProfessional security analysis tools:\n\n- Port scanning\n- Vulnerability assessment\n- Password strength analysis\n- SQL injection detection\n- XSS detection\n- Network reconnaissance\n\n**Commands:**\n```\ngenerate password\ncheck password [password]\nscan ports [target]\nsecurity scan [target]\n```\n\n### 4. Coding Assistant\n\nComprehensive development support:\n\n- Code quality analysis\n- Bug detection and debugging\n- Code optimization\n- Documentation generation\n- Best practices suggestions\n\n**Commands:**\n```\nanalyze code\ndebug code\noptimize code\nformat code\n```\n\n### 5. Research Module\n\nIntelligent information gathering:\n\n- Multi-source research\n- Data analysis (statistical, trend, comparative)\n- Web scraping\n- Knowledge base management\n- Result summarization\n\n**Commands:**\n```\nresearch [topic]\nfind information about [topic]\nanalyze data\n```\n\n### 6. Task Automation\n\nEfficient task management:\n\n- Priority-based task queue\n- Multi-threaded execution\n- Task scheduling and workflows\n- Retry mechanism\n- Performance monitoring\n\n```python\nfrom src.modules.task_automation import TaskAutomation, TaskPriority\n\nautomation = TaskAutomation(max_workers=5)\ntask_id = automation.create_task(\"My Task\", my_function, priority=TaskPriority.HIGH)\nautomation.submit_task(task_id)\n```\n\n### 7. NLP Conversation\n\nNatural language understanding:\n\n- Intent detection\n- Entity extraction\n- Sentiment analysis\n- Context management\n- Conversation history\n\n## 🏗️ Architecture\n\n```\nNEO/\n├── src/\n│   ├── core/\n│   │   └── ai_engine.py          # Core AI engine with learning modules\n│   ├── modules/\n│   │   ├── system_control.py     # System automation\n│   │   ├── cybersecurity.py      # Security tools\n│   │   ├── coding_assistant.py   # Code analysis\n│   │   ├── research.py           # Research capabilities\n│   │   ├── task_automation.py    # Task management\n│   │   └── nlp_conversation.py   # NLP and conversation\n│   ├── utils/\n│   │   ├── logger.py             # Logging system\n│   │   └── helpers.py            # Utility functions\n│   └── main.py                   # Main application\n├── config/\n│   ├── settings.py               # Configuration management\n│   └── neo_config.yaml           # Default configuration\n├── tests/                        # Test suite\n├── docs/                         # Documentation\n├── scripts/                      # Utility scripts\n├── models/                       # AI models (created at runtime)\n└── logs/                         # Log files (created at runtime)\n```\n\n## ⚙️ Configuration\n\n### Configuration File\n\nEdit `config/neo_config.yaml`:\n\n```yaml\nai:\n  learning_rate: 0.001\n  confidence_threshold: 0.8\n\nsystem:\n  enable_shutdown: false  # Safety first!\n  max_retries: 3\n\nsecurity:\n  enable_port_scanning: true\n  password_min_length: 12\n\ntask:\n  max_workers: 5\n```\n\n### Environment Variables\n\nCreate `.env` from `.env.example`:\n\n```bash\ncp .env.example .env\n# Edit .env with your settings\n```\n\nRequired variables:\n```\nNEO_ENV=production\nNEO_DEBUG=false\nNEO_BASE_DIR=/path/to/neo\n```\n\nOptional (for enhanced features):\n```\nOPENAI_API_KEY=your_key\nANTHROPIC_API_KEY=your_key\n```\n\n## 🛠️ Development\n\n### Setup Development Environment\n\n```bash\n# Clone repository\ngit clone https://github.com/yourusername/neo.git\ncd neo\n\n# Install in development mode\npip install -e \".[dev]\"\n\n# Install pre-commit hooks\npre-commit install\n```\n\n### Running Tests\n\n```bash\n# All tests\n./scripts/test.sh\n\n# Specific test file\npython -m pytest tests/test_ai_engine.py -v\n\n# With coverage\npython -m pytest tests/ --cov=src --cov-report=html\n```\n\n### Code Style\n\n- Follow PEP 8\n- Use type hints\n- Write docstrings\n- Maximum line length: 120 characters\n\n```bash\n# Format code\nblack src/ tests/\n\n# Check style\nflake8 src/ tests/\n\n# Type checking\nmypy src/\n```\n\n## 📚 Documentation\n\n- [User Guide](docs/USER_GUIDE.md) - Comprehensive usage guide\n- [Development Guide](docs/DEVELOPMENT.md) - Developer documentation\n- [API Reference](docs/API.md) - API documentation (coming soon)\n- [Contributing Guidelines](CONTRIBUTING.md) - How to contribute\n- [Changelog](CHANGELOG.md) - Version history\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.\n\n### Quick Contribution Steps\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Make your changes\n4. Run tests (`./scripts/test.sh`)\n5. Commit your changes (`git commit -m 'Add amazing feature'`)\n6. Push to the branch (`git push origin feature/amazing-feature`)\n7. Open a Pull Request\n\n## 🐛 Bug Reports \u0026 Feature Requests\n\nPlease use [GitHub Issues](https://github.com/yourusername/neo/issues) to report bugs or request features.\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- PyTorch team for deep learning framework\n- FastAPI team for web framework\n- All contributors and supporters\n\n## 📞 Support\n\n- Documentation: [docs/](docs/)\n- Issues: [GitHub Issues](https://github.com/yourusername/neo/issues)\n- Discussions: [GitHub Discussions](https://github.com/yourusername/neo/discussions)\n\n---\n\n**Built with ❤️ by the NEO Development Team**\n\n*Empowering digital transformation through intelligent automation* 🔹\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashab-cyber%2Fneo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyashab-cyber%2Fneo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashab-cyber%2Fneo/lists"}