AndersonBY/vector-vein

VectorVein – 무코드 AI 워크플로우 빌더

무엇인가요 – VectorVein은 코드를 작성하지 않고 AI 기반 자동화 워크플로우를 설계하고 실행할 수 있는 데스크톱 애플리케이션입니다. 대규모 언어 모델(LLM) 호출, 임베딩, 음성-텍스트 변환, 기타 AI 서비스를 드래그 앤 드롭 방식의 시각적 에디터로 통합하며, LangChain/LangFlow와 유사한 인터페이스를 제공하지만 실행 가능한 단일 프로그램으로 패키징되었습니다.

주요 기능

• 시각적 워크플로우 에디터 – LLM 호출, 임베딩, 파일 입출력, 웹 크롤링 등 다양한 노드를 캔버스에 배치하고 연결할 수 있습니다.
• 다중 LLM 백엔드 지원 – OpenAI 호환 엔드포인트(OpenAI, Azure, Ollama, LM‑Studio, vLLM 등)를 자유롭게 설정할 수 있습니다. 별도의 엔드포인트 및 모델 설정을 통해 다양한 제공업체를 혼합 사용할 수 있습니다.
• 임베딩 지원 – OpenAI 임베딩 또는 로컬 서비스(HuggingFace text‑embeddings‑inference 등)를 사용할 수 있습니다.
• 음성 인식 – OpenAI 호환 ASR 서비스(Groq 등)를 연결하고, 음성으로 시작하는 단축키를 설정하여 스크린샷을 캡처해 에이전트로 전송할 수 있습니다.
• 로컬 FastAPI API – 내장된 REST 서버(http://localhost:8787)를 통해 워크플로우 목록 조회, 검사, 프로그래밍 방식으로 실행이 가능합니다.
• 템플릿 및 튜토리얼 – 공식 템플릿과 인터랙티브 온라인 튜토리얼을 통해 새로운 사용자가 일반적인 워크플로우(예: 웹 기사 요약 → 마인드맵 생성)를 빠르게 구축할 수 있습니다.
• 크로스플랫폼 데스크톱 – pywebview(Windows에서는 WebView2)로 패키징되어 Windows, macOS, Linux용 단일 실행 파일로 배포됩니다.

시작 방법

1. 다운로드 – GitHub의 Releases 페이지에서 최신 릴리스를 다운로드합니다. ZIP 파일을 해제하면 SQLite 데이터베이스와 정적 자산용 data 폴더가 생성됩니다.
2. WebView2 런타임 설치 (Windows 전용) – 앱이 시작되지 않으면 WebView2 런타임을 설치하세요.
3. LLM 엔드포인트 설정 – 설정 → API 엔드포인트 탭에서 OpenAI 호환 URL(예: Ollama용 http://localhost:11434/v1/)을 추가하고, 원격 LLM 또는 사용자 정의 LLM에서 모델을 선택하거나 추가합니다.
4. 임베딩 백엔드 추가 – 벡터 검색이 필요할 경우, 동일한 엔드포인트 설정 UI를 사용하여 설정합니다.
5. 워크플로우 생성 – 왼쪽 패널에서 노드를 캔버스로 드래그하여 연결하고, 노드 파라미터를 설정한 후 저장합니다.
6. 실행 – 사용자 인터페이스 탭에서 실행하거나, 로컬 API를 통해 호출할 수 있습니다:

   import requests
   resp = requests.post('http://localhost:8787/api/workflow/run', json={
       'wid': 'my-workflow-id',
       'input_fields': [{'node_id':'node1','field_name':'input','value':'Hello'}],
       'wait_for_completion': True
   })
   print(resp.json()['data'])
   

개발자 참고

• 백엔드: Python 3.8–3.11, PDM으로 관리. pdm install 후 pdm run dev로 FastAPI 서버를 시작합니다.
• 프론트엔드: Vue 3 + Vite. pnpm install로 설치하고 pnpm exec vite build로 빌드(또는 제공된 단축 명령 pdm run build-front 사용).
• 패키징: pdm run build로 pyinstaller를 사용해 단일 실행 파일을 생성합니다.
• 데이터베이스 마이그레이션은 backend/models 내의 작은 헬퍼로 처리됩니다. 스키마 변경 후 설명된 대로 마이그레이션 스크립트를 실행하세요.
• CI/CD: GitHub Actions가 태그된 릴리스에 대해 자동으로 Windows/macOS/Linux용 ZIP 파일을 빌드합니다.

대상 사용자 – 프로그래밍 능력이 없어도 LLM, 임베딩, 음성-텍스트 변환을 반복 가능한 자동화에 활용하고 싶은 사용자, 또는 자신의 코드에 논리를 통합하기 전에 빠르게 시각적 프로토타이핑이 필요한 개발자.

라이선스 – 오픈소스. 개인적 비영리 목적 사용은 무료입니다 (자세한 내용은 LICENSE.md 참조).