Skip to content

About

No-code AI workflow. Drag and drop workflow nodes and use your workflow with your AI agents.

Topics

Resources

Stars

940 stars

Watchers

9 watching

Forks

Repository files navigation

English | 简体中文 | 日本語

VectorVein

VectorVein

A local desktop application for Task Agents and visual workflows.

Everyday work rarely lives in a single file. You often need to read across local project folders, cross-check rules or reference documents, process spreadsheet data, and turn the findings into a clean report or workbook. VectorVein brings autonomous Task Agents and reusable visual workflows into one desktop workspace: give an Agent a goal when the job involves exploring files, searching documents, and multi-step execution; build a visual workflow when you want a fixed sequence of steps for batch processing and document export—or attach any valid workflow to an Agent as a callable tool.

VectorVein Task Agent Workbench

Download Desktop v1.0.2 · Setup & Configuration Guide · Quickstart Tutorial · Cloud Edition · Online Docs


See It in Action

In the demonstration task pictured below, a local project folder holds a launch brief and 5 days of daily channel sales and refund records, while a mounted knowledge base stores the 5-day channel reporting definitions and return policies. We ask the Agent to analyze the autumn launch across channels using the knowledge base's reporting rules, write a report to outputs/, and cite its sources.

From those sample files, the Agent calculates 649 total orders and ¥207,230 in net sales across the three channels, flags the 7-day return window caveat, and saves outputs/渠道复盘.md. Once completed, you can preview the formatted report, toggle its Markdown source, browse project files, and open the cited knowledge-base documents side by side in the workspace.

Previewing a completed report, toggling source view, and inspecting knowledge citations in the task workspace


Key Capabilities

Task Workspace & Multi-Folder Projects

VectorVein opens directly to the Task Agent Workbench. You can group one or more local folders into a Project (the first folder serves as the default working directory, and any additional folders act as allowed roots) so the Agent can search, read, and write project files within clear boundaries—or start a standalone task without selecting a Project.

Inside a task, the conversation and the multi-tab workspace sit side by side. Generated reports, local code files, command output, tool results, and task plans maintained when needed by the model open in separate tabs. Even while a task is running or waiting for input, you can switch the active model, reasoning effort, or approval mode (ask every time, automatic risk review, or full access) from the bottom bar.

Task detail and side-by-side workspace

Hierarchical Knowledge Bases & Hybrid Search

The Data space manages hierarchical Knowledge Bases alongside Relational Databases. Import folder trees or individual PDF, Word, Excel, PowerPoint, Markdown, and CSV files. VectorVein copies imported files into managed storage to extract text and build local indexes, leaving your original files on disk untouched—deleting an entry from a knowledge base never deletes your source file.

Each knowledge base uses a built-in local Qdrant vector index and full-text search with no external database setup required, and includes one-click presets for local Vekai embedding and reranking services. When mounted to an Agent, documents are accessible both through dedicated retrieval tools and as read-only .knowledge/ virtual paths that can be previewed directly in the task workspace.

Hierarchical knowledge base management

Browsing folders, previewing documents, and running hybrid search in a knowledge base

Extending Agents with Skills, MCP & Workflows

Save custom Agent profiles with tailored instructions, permissions, and configurable tools and capabilities:

  • Skills: Write SKILL.md bundles in the built-in editor or scan and import existing skills from ~/.agents/skills, ~/.codex/skills, and ~/.claude/skills.
  • MCP Servers: Connect local or remote MCP servers, test connections to discover available tools, and enable specific tools per Agent or per task.
  • Workflows as Tools: Attach any valid (VALID) visual workflow to an Agent so the Agent can invoke it with structured inputs and link the run record to the task.

Agent Tools & Capabilities configuration card with a mounted skill

Visual Scheduling & Background Runs

Use the visual schedule editor to run recurring inspections, summaries, or workflow pipelines on daily, weekly, or custom intervals without writing Cron expressions. Agent schedules can either start a fresh task on every run or continue inside an existing task, with options to hide completed tasks from the main list and send native desktop notifications. On Windows, closing the window can minimize VectorVein to the system tray so schedules and indexing continue in the background.

Schedule run mode, timetable, and completion actions

Visual Workflows & Structured Document Exports

When a process follows a fixed sequence of steps, build a node graph in the visual workflow editor. Workflows can read multi-sheet Excel files with source row numbers preserved, validate LLM outputs against a JSON Schema with optional local caching, and export formatted multi-sheet .xlsx workbooks, structured .docx documents, and .png charts.

Every workflow can be run from its clean daily-use screen, triggered via the local HTTP API (http://127.0.0.1:8787 by default), or executed headlessly with VectorVeinCLI.

Visual workflow editor


Quick Start

  1. Download & Launch: Download the v1.0.2 archive (vector-vein-windows-v1.0.2.zip, vector-vein-mac-v1.0.2.zip, or vector-vein-linux-v1.0.2.zip) from GitHub Releases, extract it, and run VectorVein. The desktop UI supports English and Simplified Chinese (note: the screenshots above show the Chinese interface).
  2. Configure a Model: Open Settings in the top-right corner, add a cloud API endpoint (OpenAI, Anthropic, DeepSeek, Gemini, Qwen, etc.) or a local server (Ollama, LM Studio, vLLM), click Test to verify the connection, and save. (Application data is stored locally in data/; when you use a cloud model or external MCP service, task prompts and relevant context are sent to that configured provider.)
  3. Start a Task: Mount any desired Knowledge Bases or Skills on your Agent profile under Agent, then return to the Workbench, choose a Project (optional), Agent, and model preset, and enter your goal. See the Setup & Configuration Guide and Quickstart Tutorial for details.

Important

Upgrading from 0.x: Exit any running 0.x instance (including the system tray process) before starting 1.0. On first launch, VectorVein automatically backs up your data directory to a sibling ZIP archive and verifies it before migrating your data; if the backup or verification fails, the upgrade stops immediately. After migration, legacy conversation Agent history is removed from the active database (and preserved in the backup ZIP), while Relational Databases are kept and legacy vector datasets are imported into Knowledge Bases. See the Upgrade Guide.


Documentation & Development

Build from Source

Requires Python >=3.12, <3.13 (with PDM), Node.js 22, and pnpm 10.

cd frontend && pnpm install
cd ../backend && cp .env.example .env
pdm install          # On macOS: pdm install -G mac
pdm run build-front
pdm run dev

See the Development, Testing & Build Guide for test commands, database migrations, and packaging instructions.


License

VectorVein is distributed under the VectorVein License solely for non-commercial research purposes. See LICENSE for the full license terms and restrictions.

About

No-code AI workflow. Drag and drop workflow nodes and use your workflow with your AI agents.

Topics

Resources

Stars

940 stars

Watchers

9 watching

Forks

Releases

Packages

Used by

Contributors

Languages