Redleaf Hub is the central desktop launcher and project manager for the Redleaf Knowledge Graph ecosystem. Built in Flutter, it acts as the grand orchestrator between your Redleaf Python/Flask backend instances and your Node Leaf visual RAG canvas.
Instead of manually managing terminal windows, Python environments, and scattered folders, Redleaf Hub gives you a sleek, dark-themed UI to create, launch, and manage isolated knowledge bases from a single place.
- Project Library: A clean, minimalist ui list of all your Redleaf knowledge bases.
- Offline Project Generation: Caches a master template of the Redleaf repository locally. Creating a new project clones it directly from your hard drive, completely internet-independent.
- Smart Server Detection: Click "Pop Terminal Server" to spawn a native OS terminal running the backend. The Hub silently polls the server and illuminates a green "Online" indicator when the database is unlocked and ready.
- Node Leaf Integration: Once a server is live, a launcher bar slides up allowing you to instantly boot your compiled Node Leaf visual canvas.
- Conda Environment Support: Automatically injects shell hooks and
conda activate <env>commands into the terminal before booting the Python server. - Custom Fork Support: Define your own Git URL in the settings to pull down custom enterprise or private forks of the Redleaf engine.
- Flutter SDK (Desktop support enabled for Linux, Windows, or macOS)
- Git installed and accessible from your system path.
- Python 3.9+ (or Conda).
-
Clone the repository:
git clone https://github.com/nathanfx330/Redleaf-Hub.git cd Redleaf-Hub -
Install dependencies:
flutter pub get
-
Run the app:
flutter run -d linux # or windows, macos -
Build the standalone executable:
flutter build linux # Finds the output in build/linux/x64/release/bundle/
On the first launch, you will be greeted by the Setup Screen.
- Master Projects Folder: Select an empty folder on your hard drive where all future Redleaf databases will live.
- Node Leaf Executable: Point the Hub to the compiled binary of your Node Leaf canvas (e.g.,
.../build/linux/x64/release/bundle/node_leaf). - Conda Environment (Optional): If your Redleaf Python dependencies live inside a Conda environment, type the name here (e.g.,
redleaf-env). - Template Git URL: The default Redleaf repository URL. Change this if you maintain a private fork.
The Workflow:
- Click Download Required Master Template to pull the engine down to your hidden cache.
- Click Create New Redleaf Repo to spin up an isolated, offline instance.
- Click Pop Terminal Server on your new project.
- Wait for the indicator to turn Online, then click Launch Node Leaf.
MIT License
Copyright (c) 2026 Nathaniel Westveer
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.