Local RAG Factory

Build a local lexical retrieval index over the bundled text corpus, answer questions by retrieving source evidence, and check the answers against versioned known-answer tests. No hosted embedding or LLM service is required.

Run locally

Requires Go and Python 3.12+. Blender Render Farm also requires Docker. Run from a fresh checkout:

git clone https://github.com/UFFeScience/akoflow-examples.git
cd akoflow-examples/generative-ai/local-rag
./prepare.sh && ./run.sh

Preparation downloads the Go YAML module. Results are in outputs/manifest.json, outputs/dag-validation.json, and outputs/stage-<activity>.json. Independent branches run concurrently as soon as their own dependencies and a local execution slot are available.

Inspect the same DAG in Desktop

Start the local AkôFlow daemon with Docker available and configure AKOFLOW_API_TOKEN in your shell. From this example directory:

go run ../../tools/daemon-local -root ../.. -example generative-ai/local-rag

The command builds the declared image, validates Docker connectivity, registers local-only infrastructure, and executes the workflow through the daemon. Current verified screenshots are in screenshots/current/; their manifest identifies the exact run and image. The full daemon projection is in evidence/daemon-run.json.

Public Hub version and measured execution

Open this workflow and its results · Documentation

Import into AkôFlow Desktop

Create workflow → Import from Hub → paste this immutable URI:

akoflow://hub/publications/f00526cb-8aa2-4bcf-b28d-8d76c47588fb/versions/1

The URI imports the workflow definition. Build or pull the public image and register the companion environment.yaml, scope.yaml, and topology.yaml from this source bundle before planning a local execution. No hosted account, GPU or cloud capacity is required for this CPU profile.

Image: ghcr.io/uffescience/akoflow-examples/local-rag-factory@sha256:e5d745eb64d392f7d8af85ea1b625cfdf5837975a2671afa84281dd0fd23c02e.

Actual homeserver results

Run hubv1-local-rag-factory-local-13e8a67e07-run-20261115t055221.758545823 completed 6/6 activities in 11.831740617752075 seconds. These are measured Docker-backed computations, not simulated timing. Cost is the configured local compute cost and excludes electricity and hardware.

Download the native experiment capture. The Hub Results tab includes the same plan, attempts, metrics and logs.

Inputs and outputs

Input fixtures and their generation code are in this bundle's data/ and scripts/ directories; inspect them together with the workflow definition and bundle configuration for profile assumptions. Fixtures are generated by the included code unless a bundle identifies an upstream dataset. No repository-wide LICENSE file is currently present: inspect the bundle and upstream terms before redistributing source or data; publication here does not grant additional rights. Outputs expected from this workflow:

• documents.json
• chunks.json
• index.json
• retrieval.json
• answers.json
• evaluation.json

Download the actual validated output files.

Illustrated walkthrough

The following reference screenshots come from the documentation walkthrough. The current measured run is recorded separately above.

answer

chunk

evaluate

index

ingest

retrieve

workflow