Skip to content

aidancrilly/LLMAgentFortranProject

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LLMAgentFortranProject

Note: WORK IN PROGRESS, lots of vibe-coding with testing

An Ollama-powered tool-calling agent designed to inspect Fortran projects, answer code questions, and draft git command sequences that implement requested changes. The assistant talks directly to Ollama's Python client and advertises a small suite of local tools (file reader, code search, git helpers, etc.) that the model can invoke as needed.

Prerequisites

  • Python 3.10+
  • Ollama running locally with a lightweight model pulled (defaults to gemma3:1b)
  • Access to the Fortran codebase you want the agent to explore

See the Ollama PoC guide for a quick start on configuring Ollama.

Running the Agent

python query.py \
  --project-root "<path to source>" \
  --repo-root "<path to base>" \
  --model "gemma3-tools:1b"

Important flags:

  • --project-root: directory containing the Fortran sources (used by read/search tools)
  • --repo-root: git repository root (used by git status/diff/plan tools)
  • --base-branch: default branch that git plans should branch from
  • --context-file: priming instructions injected when the session starts

Inside the REPL, ask natural-language questions, agent will invoke tools.

For change requests, the agent will inspect the relevant files and then return a git command recipe (branch creation, patch stub, staging, commit message) so you can apply the edits manually - automation is WIP.

About

Using an LLM agent to inspect a fortran project and act as an agent

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages