TzuFlow

🚀 TzuFlow: Visual Node Editor for Local AI

A visual node-based workflow editor to orchestrate local AI agents via Ollama. Build modular, private AI pipelines without writing code.

---

🧠 What is TzuFlow?

TzuFlow is a powerful, intuitive visual scripting environment inspired by Unreal Engine Blueprints and Blender Nodes, but built specifically for Local Large Language Models (LLMs). Instead of writing complex Python scripts or relying on paid cloud APIs, you can visually connect nodes to create sophisticated AI automation pipelines that run 100% on your own machine.

✨ Key Features

• 🔒 100% Private & Offline: Your data never leaves your computer. Connects directly to your local Ollama instance.
• 🧩 24+ Specialized Nodes: From AI Agents and Memory storage to Web Scraping, File I/O, Audio Transcription (Whisper), and Text-to-Speech (Windows TTS & Orpheus).
• 🔄 Advanced Flow Control: Built-in Sequencers, Iterators, Switches, and Dispatchers to handle complex logic, loops, and conditional branching effortlessly.
• ⚡ Optimized for Local Hardware: Smart context estimation, auto-retry on truncation, and efficient KV-cache management to get the most out of consumer GPUs.
• 🎨 Clean & Organized: Visual grouping frames, customizable node colors, and a clutter-free canvas designed for complex projects.

🛠️ How It Works

1. Install Ollama: Download and run Ollama in the background, and pull your favorite models (e.g., qwen2.5:7b, ornith-1.5:9b, or llama3).
2. Build Your Workflow: Drag and drop nodes onto the canvas. Connect an Input to an Agent, route it through a Sequencer, and save the result with a File Write node.
3. Hit Play: Watch your data flow through the graph in real-time, with live execution highlighting and progress tracking.

💡 Perfect For

• Game Developers generating procedural lore, items, or dialogue trees.
• Writers and Researchers automating document summarization and translation.
• Power Users building personal AI assistants with custom memory and web-search capabilities.
• Anyone who wants the power of AI automation without subscription fees or privacy concerns.

---

⚙️ System Requirements

• OS: Windows 10 / 11 (64-bit)
• Framework: .NET Framework 4.8 (Installer will prompt if needed)
• Dependency: Ollama must be installed and running in the background.
• Hardware: Depends on the Ollama model you choose. 8GB+ RAM recommended for 7B-9B models.

📚 Documentation & Support

TzuFlow comes with a comprehensive, built-in help system. Every node has a dedicated documentation page accessible directly from its configuration panel.
👉 Read the Full Online Documentation Here

🙏 Credits & Acknowledgments

TzuFlow is developed by ShadowTzu (creator of Tzu3D).
This project stands on the shoulders of giants and utilizes several excellent open-source libraries:

• Ollama (Local LLM runtime)
• Newtonsoft.Json (Data serialization)
• ScintillaNET (Code editing)
• HtmlAgilityPack (Web scraping)
• NAudio (Audio processing)

This project is in active development. Future updates will include new nodes, performance improvements, and quality-of-life features. Your support (even just a download!) helps keep this project alive. Thank you!