{"id":23934392,"url":"https://github.com/Vasco0x4/Neo-AI","last_synced_at":"2025-09-11T17:31:57.692Z","repository":{"id":269461518,"uuid":"853725215","full_name":"Vasco0x4/Neo-AI","owner":"Vasco0x4","description":"Neo AI integrates into the Linux terminal, capable of executing system commands and providing helpful information. ","archived":false,"fork":false,"pushed_at":"2024-12-23T17:49:21.000Z","size":20244,"stargazers_count":98,"open_issues_count":2,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-03T10:08:23.993Z","etag":null,"topics":["ai","gpt","ia","kali-linux","linux","llama","ubuntu"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Vasco0x4.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-09-07T11:07:14.000Z","updated_at":"2024-12-26T23:20:06.000Z","dependencies_parsed_at":"2024-12-23T18:46:24.248Z","dependency_job_id":null,"html_url":"https://github.com/Vasco0x4/Neo-AI","commit_stats":null,"previous_names":["vasco0x4/neo-ai"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vasco0x4%2FNeo-AI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vasco0x4%2FNeo-AI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vasco0x4%2FNeo-AI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vasco0x4%2FNeo-AI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vasco0x4","download_url":"https://codeload.github.com/Vasco0x4/Neo-AI/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232658967,"owners_count":18557019,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","gpt","ia","kali-linux","linux","llama","ubuntu"],"created_at":"2025-01-06T00:35:34.510Z","updated_at":"2025-09-11T17:31:57.662Z","avatar_url":"https://github.com/Vasco0x4.png","language":"Python","funding_links":[],"categories":["Terminal"],"sub_categories":[],"readme":"# Neo AI - Your Intelligent Linux Terminal Assistant\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"assets/demo.gif\" width=\"400\" alt=\"Neo AI Terminal Banner\"\u003e\r\n\u003c/div\u003e\r\n\r\nNeo is an AI assistant designed to enhance your Linux terminal experience. It seamlessly integrates with your environment to execute commands, provide system insights, and assist with both everyday tasks and cybersecurity operations. With support for multiple AI backends including LM Studio, OpenAI, and Anthropic's Claude via DigitalOcean.\r\n\r\n## 🌟 Features\r\n\r\n- **Intelligent Command Execution**: Neo understands your intent and executes Linux commands with proper context awareness\r\n- **Multi-Protocol Support**: Interact with your system through specialized protocols for terminal, files, networks, and security tasks\r\n- **Terminal UI**: Enjoy a responsive, syntax-highlighted interface with command history and auto-completion\r\n- **Terminal**: Neo execute commands in a dedicated terminal window for better visibility and interaction\r\n- **Security-Focused**: Built-in approval system for commands to maintain security and control\r\n- **Cybersecurity Tools**: Support for network scanning, security analysis, and CTF challenges\r\n- **Multiple AI Backends**: Works with various AI models through different providers:\r\n  - **LM Studio**: Run models locally with LM Studio\r\n  - **DigitalOcean**: Connect to DigitalOcean's AI platform\r\n  - **OpenAI**: Access GPT models via DigitalOcean integration\r\n  - **Anthropic/Claude**: Claude models via DigitalOcean integration\r\n\r\n## 🎥 Demo\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"https://youtu.be/RAWu0XJIHF8\"\u003e\r\n    \u003cimg src=\"https://img.youtube.com/vi/RAWu0XJIHF8/maxresdefault.jpg\" width=\"700\" alt=\"Neo AI Demo\"\u003e\r\n  \u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"https://youtu.be/RAWu0XJIHF8\"\u003e\u003cb\u003eSee Neo in action by watching demo\u003c/b\u003e\u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n\r\n### Prerequisites\r\n\r\n- Linux-based operating system\r\n- Python 3.6 or higher\r\n- Pip package manager\r\n- One of the following terminal emulators: gnome-terminal, konsole, xfce4-terminal, mate-terminal, terminator, tilix, kitty, or alacritty\r\n- One of the following AI backends:\r\n  - **LM Studio**: For local model execution\r\n  - **DigitalOcean API account**: For cloud-based execution with OpenAI or Anthropic models\r\n\r\n### Installation\r\n\r\n1. Clone the repository:\r\n```bash\r\ngit clone https://github.com/vasco0x4/neo-ai.git\r\ncd neo-ai\r\n```\r\n\r\n2. Run the installation script:\r\n```bash\r\n./install.sh\r\necho \"alias neo='source $(pwd)/venv/bin/activate \u0026\u0026 python3 $(pwd)/main.py'\" \u003e\u003e ~/.bashrc\r\n```\r\n\r\n3. Configure Neo:\r\n```bash\r\ncp config/config.yaml.example config/config.yaml\r\n# Edit the configuration file with your preferred settings\r\nnano config/config.yaml\r\n```\r\n\r\n4. Start Neo:\r\n```bash\r\nsource ~/.bashrc\r\nneo\r\n```\r\n\u003e Note maybe you need to restart you terminal\r\n\r\n\r\n## 🔧 Configuration\r\n\r\nNeo can be configured using the `config/config.yaml` file to connect with your preferred AI provider:\r\n\r\n```yaml\r\n# Operation Mode\r\nmode: \"digital_ocean\"  # Options: 'lm_studio' or 'digital_ocean'\r\n\r\n# LM Studio Configuration (Local)\r\napi:\r\n  key: \"lm-studio\"\r\n  url: \"http://localhost:6959/v1\"\r\n  model: \"your-model-name\"\r\n\r\n# DigitalOcean Configuration (Cloud)\r\ndigital_ocean:\r\n  agent_id: \"your-agent-id\"\r\n  agent_key: \"your-agent-key\"\r\n  agent_endpoint: \"https://your-endpoint.app/api/v1\"\r\n  model: \"model-name\"  # Can be a DigitalOcean, OpenAI, or Anthropic model\r\n\r\n# Security Settings\r\nsecurity:\r\n  auto_approve_commands: false\r\n  require_approval: true\r\n```\r\n\r\n## 💻 Using Neo\r\n\r\n### Machine Communication Protocol (MCP)\r\n\r\nNeo communicates with your system using a protocol system. Here are the key protocols available:\r\n\r\n| Protocol | Description | Example Usage |\r\n|----------|-------------|---------------|\r\n| `terminal` | Execute shell commands | `ls -la`, `ps aux`, etc. |\r\n| `files` | Manage file operations | Read, write, or list files |\r\n| `analyze` | Comprehensive system analysis | CPU, memory, disk usage |\r\n| `network` | Network operations | Interface info, connections, scanning |\r\n| `security` | Security assessments | User info, open ports, vulnerabilities |\r\n\r\n### Example Interactions\r\n\r\n```\r\nYou: List all running processes\r\n\r\nNeo: I'll use the `ps` command to list all running processes.\r\n\u003cmcp:terminal\u003eps aux\u003c/mcp:terminal\u003e\r\n\r\nneo \u003e ps aux\r\n  ↳ Execute this command? [Enter/n]: _\r\n\r\nHere are the top processes by CPU usage:\r\n1. firefox (23.4%)\r\n2. chromium (15.2%)\r\n3. ...\r\n```\r\n\r\n```\r\nYou: Can you scan my local network?\r\n\r\nNeo: I'll scan your local network. This may take a moment:\r\n\u003cmcp:network\u003escan:192.168.1.0/24\u003c/mcp:network\u003e\r\n\r\nneo \u003e nmap -F 192.168.1.0/24\r\n  ↳ Execute this command? [Enter/n]: _\r\n\r\nFound 12 active devices:\r\n```\r\n\r\n## 🔐 Security\r\n\r\nNeo is designed with security in mind:\r\n\r\n- **Command Approval**: All commands require **explicit approval**\r\n- **Minimal Privileges**: Neo operates with your user permissions by default\r\n- **Secure Configuration**: API keys are stored locally in your configuration\r\n\r\n### Custom Context\r\n\r\nNeo automatically gathers system information at startup, but you can add additional context:\r\n\r\n```bash\r\n# Add persistent memory entry\r\necho \"Custom Info: Value\" \u003e\u003e /tmp/persistent_memory.txt\r\n```\r\n\r\n### Executing Interactive Commands\r\n\r\nNeo can handle interactive commands like vim, nano, or top. When using these, a dedicated interactive session will be created.\r\n\r\n## 🤝 Contributing\r\n\r\nContributions are welcome! Please feel free to submit a Pull Request.\r\n\r\n## 📜 License\r\n\r\nThis project is licensed under the BSD 3-Clause License - see the [LICENSE](LICENSE) file for details.\r\n\r\n---\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVasco0x4%2FNeo-AI","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FVasco0x4%2FNeo-AI","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVasco0x4%2FNeo-AI/lists"}