whatisgithub

What is savannaflow?

eres45/savannaflow — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · hard

In one sentence

A benchmarking tool that compares plain AI, vector search, and graph search side by side to show which answers questions most efficiently.

Mindmap

mindmap
  root((SavannaFlow))
    What it does
      RAG benchmarking
      GraphRAG traversal
      Live comparison dashboard
    Tech stack
      Python
      FastAPI
      TigerGraph
      Groq
    Use cases
      RAG cost comparison
      Graph query learning
      Aerospace data demo
    Audience
      AI developers
      Hackathon builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Compare token cost and accuracy across LLM-only, vector RAG, and graph RAG approaches.

USE CASE 2

Learn how a GraphRAG pipeline traverses relationships instead of retrieving whole documents.

USE CASE 3

Use the live dashboard to test questions against NASA aerospace data.

USE CASE 4

Reference the project structure as a starting point for building a graph-backed RAG system.

What is it built with?

PythonFastAPINext.jsTigerGraphGroqChromaDB

How does it compare?

eres45/savannaflow0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyhardmoderatehard
Complexity4/54/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires TigerGraph, Groq, and HuggingFace API credentials configured in a .env file.

So what is it?

SavannaFlow is a benchmarking platform that compares three different approaches to answering questions with AI: using a language model alone, using a standard method called Basic RAG, which stores text as vectors for similarity search, and GraphRAG, which stores information as a connected graph of relationships. The project was built for a hackathon using TigerGraph Savanna, a graph database, as its backbone. The core problem it addresses is what the README calls the Vector RAG Tax. When standard RAG systems search for an answer, they retrieve entire paragraphs of text, often over a thousand tokens, even when the actual answer is a single fact. SavannaFlow's GraphRAG approach instead traverses a graph of specific nodes and relationships, fetching only the precise data needed. For example, to find which contractor built a particular rocket engine, it follows a direct path through the graph rather than loading unrelated NASA history text. The platform uses NASA aerospace data as its test dataset. Users can submit a question and see all three approaches run side by side in real time, with metrics like token usage, cost per query, and accuracy displayed together. According to the benchmark results in the README, GraphRAG achieves roughly 3.5 times fewer tokens than Basic RAG while maintaining the same accuracy. The backend is written in Python using FastAPI, and the frontend dashboard uses Next.js. AI responses are generated through Groq, running an open-source large language model. The project also includes an automated accuracy scorer that acts as an AI judge to evaluate each answer, and a live demo dashboard is deployed for public testing.

Copy-paste prompts

Prompt 1
Explain how the GraphRAG pipeline in SavannaFlow traverses the TigerGraph database.
Prompt 2
Walk me through setting up the .env file needed to run SavannaFlow locally.
Prompt 3
Show me the difference between the basic_rag.py and graph_rag.py pipelines in this project.
Prompt 4
Help me understand the LLM-as-a-judge accuracy scoring used in this benchmark.

Frequently asked questions

What is savannaflow?

A benchmarking tool that compares plain AI, vector search, and graph search side by side to show which answers questions most efficiently.

What language is savannaflow written in?

Mainly Python. The stack also includes Python, FastAPI, Next.js.

How hard is savannaflow to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is savannaflow for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.