pratik-3706/norvexum

Norvexum is a command line and terminal interface tool that acts as an AI coding assistant, written in Rust. It connects to AI models from Gemini, Claude, OpenAI, and AICredits.in, and uses them to autonomously work through coding tasks: reading and editing files, running shell commands, checking installed packages for known vulnerabilities, and searching the web for information or images. Everything the AI does is confined to the project workspace. Norvexum checks every file path and shell command argument, including tricks like parent directory traversal or home directory shortcuts, to make sure the assistant cannot touch anything outside the folder you are working in. Commands that look risky or cannot be safely checked ask for your approval before running, and a list of especially dangerous programs is blocked outright. The tool can also handle images. It reads image files you point it to, sends them to AI models that support images, and falls back to an OCR service to read text out of pictures when the chosen model cannot see images itself. There is also a built in image search and download feature, plus a dedicated client for pulling anime and game character art from Zerochan, alongside a general web image search through DuckDuckGo. Before installing packages with pip or npm, Norvexum runs a safety check against the Open Source Vulnerabilities database and looks for typosquatting, which is when a malicious package uses a name almost identical to a popular one, to reduce the chance of accidentally installing something harmful. To use it, you need Rust and Cargo installed, then you build and install the tool from the cloned repository. Running the setup command creates a configuration folder where you place your API keys for the AI providers and search services you plan to use. From there you can start an interactive chat session in the terminal interface, run it in a plain text mode without the visual interface, or pass a single message directly from the command line. Your settings and past conversations are saved automatically so they carry over the next time you open it. The code itself is released under the MIT license, though the project's logo and loading animation graphics are kept under separate copyright and cannot be reused or sold.