{"id":23594196,"url":"https://github.com/vasco0x4/neo-ai","last_synced_at":"2025-04-07T07:19:10.255Z","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":"2025-01-23T00:08:10.000Z","size":20244,"stargazers_count":100,"open_issues_count":2,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-31T06:07:05.533Z","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":"2025-02-06T14:59:10.000Z","dependencies_parsed_at":"2025-02-28T18:14:13.929Z","dependency_job_id":"c3559d49-ea5f-46c8-96e9-49a75a64b756","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":247608160,"owners_count":20965953,"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":"2024-12-27T09:15:58.789Z","updated_at":"2025-04-07T07:19:10.227Z","avatar_url":"https://github.com/Vasco0x4.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Neo AI - Your Linux Terminal Assistant\r\n\r\nNeo is an AI assistant designed to enhance your Linux terminal experience. It understands command context, executes Linux commands securely, and assists with cybersecurity tasks including network scanning and CTF challenges.\r\n\r\n\r\n## 🎥 **Demo**\r\n\r\n[Coming soon]\r\n\r\n## 🔧 **How It Works**\r\n\r\nNeo operates through a system of tags and contextual awareness that allows it to interact with your Linux environment.\r\n\r\n---\r\n\r\n### **Command Processing**\r\n\r\nNeo uses two primary tag types for system interaction:\r\n\r\n- **`\u003csystem\u003e` Tags**: These tags enable Neo to execute commands.\r\n  ```markdown\r\n  User: Show me the current directory\r\n  \u003csystem\u003epwd\u003c/system\u003e\r\n  ```\r\n\r\n- **`\u003ccontext\u003e` Tags**: System context.\r\n  ```markdown\r\n  \u003ccontext\u003e\r\n  Current Directory: /home/user\r\n  Files: Documents, Downloads, Pictures, shell.php\r\n  System: Ubuntu 22.04, Kernel 5.15\r\n  \u003c/context\u003e\r\n  ```\r\n\r\n---\r\n\r\n### **System Interaction**\r\n\r\nAt each session launch, Neo automatically gathers system information such as:\r\n\r\n- System information:\r\n  ```markdown\r\n  Kernel Version: 6.8.0-49-generic\r\n  OS Info: Linux\r\n  Architecture: x86_64\r\n  Hostname: vasco\r\n  ```\r\n- Current directory location (`pwd`)\r\n- Available files and directories (`ls -a`)\r\n\r\n**Customization:** You can add more commands to the context section by simply appending them to the script. Neo will execute them automatically and send the results back with the `\u003csystem\u003e` tag.\r\n\r\n---\r\n\r\n### Example Interaction\r\n\r\n![image](https://github.com/user-attachments/assets/150653e5-7234-4f84-b67d-6a51e5202e3d)\r\n\r\n\r\n**Approval Process:**  \r\nThe user must approve each command before execution\r\n\r\nAfter execution, the output is displayed in a new GNOME window or prompts for sudo if required\r\n\r\n![image](https://github.com/user-attachments/assets/70445b99-2dac-46b4-8cef-fb08c38bdbf5)\r\n\r\nThe output command will be automatically sent to Neo\r\n\r\n![image](https://github.com/user-attachments/assets/8e2ad972-617b-4fb7-8fe0-8f6c5c482173)\r\n\r\nIf further investigation is needed Neo will ask you for execute another command\r\n\r\n![image](https://github.com/user-attachments/assets/31da3517-115d-4a76-b910-8a957095a93a)\r\n\r\nIn this way, Neo can interact with Linux with system tags. The possibilities are infinite! You can use it when you forget simple commands or need to analyze files, perform DNS forensics, or do anything on Linux. :)\r\n\r\n## ⚙️ **Server Options**\r\n\r\nCurrently, Neo requires a server to function. You can use either:\r\n\r\n1. **LM Studio** (local installation)\r\n2. **DigitalOcean API Key** (recommended)\r\n\r\nFuture compatibility with other APIs is under development.\r\n\r\n\u003e I will develop new compatibility, but it takes time. Every API has a different approach to chat, streaming, etc.\r\n\r\n\r\n## 🛠️ **Installation**\r\n\r\nFor detailed installation instructions:\r\n\r\n[Installation Guide](./docs/INSTALLATION.md)\r\n\r\n## 📜 **License**\r\n\r\nBSD 3-Clause License\r\n\r\n\u003e *Friendly tip:* Don't insult Neo—it might shut down your computer! Good luck!\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"}