Skip to content

HJyup/cf_ai_flow

Repository files navigation

Flow

Github Header Banner

An interactive, visual reasoning playground, Powered by agents. Here you and an AI can build, connect, and explore ideas together on a shared canvas.

Features

  1. AI Chat Assistant - ask questions and collaborate directly in chat.
  2. Visual Board - add, move, and connect nodes.
  3. Custom Node Editing - click any node to rename or edit inline.
  4. Realtime AI Interaction - agent can analyse the board or add new nodes
  5. Reasoning Workspace - great for visualising any problems that you have

🚧 Next Features

Collaborative Rooms via Durable Objects. Allow users to create a shared room identified by a unique ID or key. Each room is backed by a Cloudflare Durable Object (referenced by name), which maintains the diagram’s state and real-time connections.

Why?

As someone who relies heavily on Excalidraw for solving problems: from software design to algorithm reasoning - Flow takes that idea even further. It’s like Excalidraw, but powered by an AI collaborator that can help you design diagrams, summarise complex systems, and even guide you toward a solution.

Example

flow-example.mp4

Prerequisites

  • Cloudflare account
  • OpenAI API key

Quick Start

  1. Install dependencies:
pnpm install
  1. Set up your environment:

Create a .dev.vars file:

OPENAI_API_KEY=your_openai_api_key
  1. Run locally:
pnpm start
  1. Deploy:
pnpm run deploy

Learn More

License

MIT