A tool that uses formal specification and natural language specifications to generate formally verified C code automatically. The tool uses Large Language Models (LLMs) to generate code based on the given specifications. The generated code is then verified using Frama-C and Why3 to ensure that it satisfies the given formal specification. The tool can also improve existing code by generating code snippets that satisfy the given formal specification.

• Python 3.6 or higher
• Python dependencies listed in requirements.txt (python3 -m pip install -r requirements.txt)
• Frama-C (https://frama-c.com/)
• Why3 (https://why3.lri.fr/)
• Provers in the Why3 platform, i.e. Alt-Ergo, CVC4, and Z3
• .env file in the root directory with API keys for OPENAI and GROQ:

  OPENAI_API_KEY=...
  GROQ_API_KEY=...
  

• Alt-Ergo 2.4.3 (https://alt-ergo.lri.fr/)
• CVC4 1.7 (https://cvc4.github.io/)
• Z3 4.8.6

1. Clone the repository
2. Install the required Python packages:

pip install -r requirements.txt

3. Install Frama-C and Why3 using the links above

Run:

python main.py function

• improve_code_step: Executes one code improvement step on a given formal specification and program candidate
• generate_prompt: Generates a prompt from an .h file
• generate_code: Generates code using LLMs (requires API keys)
• generate_code_folder: Recursively generates code for each subfolder in a directory

The tool expects three separate files:

• Formal specification file (-fsf): contains the formal specification
• Natural language specification file (-nl): contains the natural language description
• Function signature file (-sig): contains the function signature

VeCoGen combines these specifications in the prompt. The -spectype flag controls which specifications are used:

• formal
• natural
• both

generate_code_folder processes each subfolder and generates code based on all three inputs.

Make sure you are in the python_modules directory:

python3 main.py generate_code_folder \
  -d ../paper_problems/ \
  -ieg 2 \
  -iter 2 \
  -temp 1 \
  -wpt 5 \
  -o ../output/gpt-4o \
  --output-file generated_code.c \
  -fsf formal-specification.h \
  -nl natural-language-specification.h \
  -sig function-signature.h \
  -pt one-shot \
  -spectype both \
  -provider openai \
  -model gpt-4o

This generates code for all problems in a folder.

1. Pull the image:

docker pull merlijnsevenhuijsen/vecogen

2. Create .env:

OPENAI_API_KEY=XXX
GROQ_API_KEY=XXX

3. Run:

docker run --env-file .env -it merlijnsevenhuijsen/vecogen

4. Go to:

cd python_modules

5. Run generation:

python3 main.py generate_code_folder \
  -d ../paper_problems/ \
  -ieg 2 \
  -iter 2 \
  -temp 1 \
  -wpt 5 \
  -o ../output/gpt-4o \
  --output-file generated_code.c \
  -fsf formal-specification.h \
  -nl natural-language-specification.h \
  -sig function-signature.h \
  -pt one-shot \
  -spectype both \
  -provider openai \
  -model gpt-4o

• Python 3.6+
• requirements.txt
• Frama-C
• Why3
• Alt-Ergo, CVC4, Z3

pip install -r requirements.txt

Create .env:

OPENAI_API_KEY=XXX
GROQ_API_KEY=XXX

Run:

cd python_modules

python3 main.py generate_code_folder \
  -d ../paper_problems/ \
  -ieg 2 \
  -iter 2 \
  -temp 1 \
  -wpt 5 \
  -o ../output/gpt-4o \
  --output-file generated_code.c \
  -fsf formal-specification.h \
  -nl natural-language-specification.h \
  -sig function-signature.h \
  -pt one-shot \
  -spectype both \
  -provider openai \
  -model gpt-4o

• Specifies the function to execute
• Type: str

• Enables verbose logging
• Type: bool
• Default: False

• Clears debug files
• Type: bool
• Default: False

• Directory for file operations

• C file to verify or improve

• Formal specification file

• Output directory

• Output file name

• Natural language specification

• Function signature

• natural, formal, or both

• LLM model

• LLM provider: openai, groq, llama, or openrouter

• Sampling temperature

• Allow loops in generated code

• Number of iterations

• Candidate ranking strategy: random, proof-obligations, or test-cases

python3 main.py generate_code_folder \
  -d ../paper_problems/ \
  -ieg 10 \
  -iter 10 \
  -temp 1 \
  -wpt 5 \
  -o ../output/llama3.1-8b-10-10-1-one-shot-both \
  --output-file generated_code.c \
  -fsf formal-specification.h \
  -nl natural-language-specification.h \
  -sig function-signature.h \
  -pt one-shot \
  -spectype both \
  -rank proof-obligations \
  -provider llama \
  -model llama3.1-8b

python3 main.py generate_code_folder \
  -d ../journal_problems/ \
  -samples 1 \
  -iter 1 \
  -temp 1 \
  -wpt 10 \
  -o ../output/test-gpt-5-nano \
  -of generated-code.c \
  -fsf formal_specification.h \
  -nl natural_language_specification.h \
  -pt zero-shot \
  -spectype both \
  -rank test-cases \
  -provider openai \
  -model gpt-5-nano \
  -wpm real \
  -sig function_signature.c \
  -tc solution_test.c \
  -extra extras.c