NovaCompile is an AI-powered runtime engine and transpiler designed to execute unstructured text, pseudo-code, and language files (.no) by instantly translating them into production-ready Python code on the fly using Groq Cloud infrastructure. Nova also includes lots of other features including fast language translation, code fixing, a shell, and AI coding agent with custom permissions (see docs/chat-permissions.md, and docs/usage.md).
To install a permenant binary global executable, run this install script (which installs this executable) and ignore steps 1 and 3. This is currently significantly limited of features, and will be rarely updated.
Follow these three simple steps to configure NovaCompile inside your local workspace or web-shell environment.
Run this installation script to clone the repository to get Nova on your device.
cd ~
mkdir .novacompile
cd .novacompile
git clone https://github.com/novacompile/compiler.git
cd compilerGo to console.groq.com and sign up for an account. Click API Keys, then create API key.
Warning
Remember to copy the key and put it in a safe and secure place straight away after creating it.
Run the setup script to install the dependencies through pip, create a permenant alias, and install your API key.
bash setup.shNote
To make this shortcut permanent across terminal restarts, the setup script appends the alias directly into your ~/.bashrc configuration profile.
Once configured, create a custom code file using your preferred pseudo-syntax or simplified structures.
Launch the shell directly to type Nova code interactively:
novaIf you run the transpiler without a file argument, it starts this shell automatically.
In shell mode, type a block of Nova code, then press Enter on an empty line to transpile and run it. Use exit or quit to leave.
Create a file with the .no suffix (e.g. script.no) containing your custom logic, for example:
// Define some basic variables
username is "john"
counter is 5
// Run a structural loop
loop 3 times
add 2 to counter
display text "User logged in: " and then show username
print "Current count value is: " + counter
Execute the file instantly by calling nova followed by your custom script target:
nova [filename].noIf you prefer to run the entrypoint directly, this also works:
python src/transpiler.py [filename].noWarning
To be able to run the entrypoint directly, you must be inside the root directory of compiler (by default it is ~/.novacompile/compile)
For the full documentation on usage, read usage.md.
Nova Compiler is under the MIT License. Make sure that you have read and understood it before reproducing this repo.