Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

3.5 KB
Raw Blame

RuFlo Research

Goal-Oriented Action Planning UI for autonomous AI research workflows. Part of the RuFlo platform. Live: goal.ruv.io Β· Agents dashboard: goal.ruv.io/agents

Turn plain-English research goals into executable agent plans. RuFlo Research applies classic Goal-Oriented Action Planning (GOAP) β€” A* search through a state space of actions with preconditions and effects β€” to autonomous AI research, then dispatches the work to live agents you can inspect in real time.

Highlights

🎯 Plain-English goals Describe an outcome β€” RuFlo extracts success criteria, constraints, and implicit preconditions
🧭 GOAP A* planner Shortest-path search through actions with preconditions/effects; replans on the fly when state changes
πŸ€– Live agent dashboard /agents shows every spawned agent β€” role, current step, status, trajectories
🌳 Visual plan tree Goals render as collapsible action trees with progress, blocked branches, rollbacks
♻️ Adaptive replanning When an action fails, A* re-runs from the current state instead of restarting
πŸ”Œ Embeddable widget Drop the research UI into any site via <script src="widget.js">

Quick Start

# from /v3/goal_ui
npm install
npm run dev          # main app on http://localhost:8080

For the embeddable widget:

npm run build:widget         # produces dist/widget.js + dist/widget.css
npm run widget:dev           # build widget + start dev server

Project Structure

v3/goal_ui/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/          # React components (GoalInput, AgentStep, ResearchReportModal, …)
β”‚   β”œβ”€β”€ pages/               # Index, Agents, Demo, NotFound
β”‚   β”œβ”€β”€ lib/goapPlanner.ts   # GOAP A* implementation
β”‚   β”œβ”€β”€ integrations/supabase/  # Supabase client + types
β”‚   └── widget.tsx           # Embeddable widget entry
β”œβ”€β”€ supabase/functions/      # Edge functions (research-step, generate-research-goal, …)
β”œβ”€β”€ public/                  # Static assets, widget-embed.html demo
β”œβ”€β”€ docs/                    # DEPLOYMENT.md, WIDGET-INTEGRATION.md, WIDGET_SETUP.md
└── netlify.toml             # Hosting config

Embedding the Widget

<div id="ruflo-research-widget-container"></div>
<script>
  window.RufloResearchWidgetConfig = {
    primaryColor: "#8b5cf6",
    accentColor: "#10b981",
  };
</script>
<script src="https://goal.ruv.io/widget.js"></script>
<link rel="stylesheet" href="https://goal.ruv.io/widget.css" />

The widget exposes a global window.RufloResearchWidget with init(containerId) and version for programmatic control. See docs/WIDGET-INTEGRATION.md for the full integration guide.

Tech Stack

React 18 Β· TypeScript 5 Β· Vite 5 Β· Tailwind 3 Β· shadcn/ui Β· Radix UI Β· React Query Β· React Router Β· Supabase Edge Functions Β· GOAP A* planner

Deployment

Hosted on Netlify (netlify.toml) at goal.ruv.io. See docs/DEPLOYMENT.md for self-hosting instructions and edge-function deploy steps.

Environment

Copy example.env β†’ .env and set the Supabase publishable variables (all VITE_* prefixed and safe to ship to the browser):

VITE_SUPABASE_URL=...
VITE_SUPABASE_PROJECT_ID=...
VITE_SUPABASE_PUBLISHABLE_KEY=...

License

MIT β€” same as the parent RuFlo project.