Inspiration

Particle physicists spend too much time manually creating Feynman-style diagrams in TikZ LaTeX. We wanted to automate this process—linking particle data, rules, and validation into a workflow that saves time and avoids errors.

What it does

FeynmanCraft takes particle interaction inputs and automatically generates publication-ready TikZ LaTeX diagrams. It searches the ParticlePhysics map for accurate data, validates interactions against physics rules using Gemini, and outputs clean, consistent code for research papers or presentations.

How we built it

  • Restructured the project using KIRO to modularize the workflow.
  • Designed a new frontend to replace ADK’s interface with our own clean UI.
  • Integrated fast search in the ParticlePhysics map for precise data retrieval.
  • Built an automation agent that translates particle interactions into TikZ code.
  • Added Gemini validation to check diagrams against curated physics conservation laws.

Challenges we ran into

  • Mapping physics rules into a format usable by the agent.
  • Optimizing search performance without sacrificing accuracy.
  • Designing a flexible frontend that still outputs strict LaTeX/TikZ syntax.
  • Aligning Feynman-style visuals with rule validation to avoid inconsistencies.

Accomplishments that we're proud of

  • Achieved a significant speedup in searching particle interactions.
  • Developed a custom frontend independent of ADK.
  • Successfully validated particle diagrams using Gemini + physics rules.
  • Produced clean, error-free TikZ LaTeX code that works directly in research manuscripts.

What we learned

  • How to integrate rule-based physics validation with generative code.
  • Importance of frontend usability in technical research tools.
  • KIRO restructuring made the pipeline more scalable and modular.
  • Building tools for researchers requires balancing automation with scientific rigor.

What's next for FeynmanCraft

  • Expand validation with more advanced quantum number checks.
  • Add support for dynamic diagrams (animations, interactive views).
  • Integrate directly with Overleaf for one-click TikZ export.
  • Extend beyond particle physics to general field-theory visualizations.

Built With

  • google-adk
  • kiro
  • mcp
Share this project:

Updates