Error Reference
VIBEX has a rich error system designed to communicate exactly what went wrong and who is to blame.
HallucinationError
[vibex] HallucinationError: LLM invented instructions that don't exist.
Cause: The LLM generated assembly containing instructions or syntax that do not exist in the target architecture.
Example:
mov x30, sp[[#0]] ; not a real instruction
Solutions:
- Run again. The LLM may generate valid code next time.
- Use
--workto inspect the generated assembly. - Use a larger model. Bigger models hallucinate less.
- Add
DO NOT INVENT SYNTAXto your.vibefile. (We already added this to the compiler. It helps sometimes.)
CloudError
[vibex] CloudError: HTTP 401: Unauthorized
Cause: API key is missing, invalid, or expired.
Solution: Check VIBEX_API_KEY in your .env.
[vibex] CloudError: Cannot connect to http://localhost:11434/v1: Connection refused
Cause: Your local LLM server is not running.
Solution: Start LM Studio or Ollama.
FileNotFoundError
[vibex] hello.vibe: no such file
Cause: The .vibe file does not exist.
Solution: Create the file. Write your vibes. Try again.
Bad CPU Type
zsh: bad CPU type in executable: ./hello
Cause: You compiled for x86_64 on Apple Silicon without Rosetta.
Solution:
softwareupdate --install-rosetta --agree-to-license
Or compile for arm64:
vibex hello.vibe -o hello --arch arm64
It Compiled But Does The Wrong Thing
This is not an error. This is non-deterministic compilation. Run vibex again.
If it keeps doing the wrong thing, your .vibe file may be ambiguous. Try being more specific.
Instead of:
Do the thing.
Try:
Print the numbers from 1 to 10, one per line.
It Works On My Machine
Classic. Use --work to save the generated assembly and share it with your colleagues.
They will not understand it either.