mario-andreschak/FLUJO

FLUJO – 개인용 AI 에이전트를 위한 시각적 빌더

무엇인가요 – FLUJO는 오픈소스이며 로컬에서 호스팅되는 플랫폼으로, 대규모 언어 모델(LLM) 제공자(OpenAI, Anthropic, Gemini, Ollama 등) 및 외부 "MCP" 서비스에 연결한 후, 간단한 단계별 레시피 UI 또는 드래그 앤 드롭 흐름 다이어그램을 사용하여 채팅 기반 에이전트를 조합할 수 있습니다. 데이터와 API 키는 의도적으로 서비스를 공개하지 않는 한, 당신의 컴퓨터(또는 사설 네트워크)에 머무릅니다.

주요 기능

• 로컬 우선 보안 – 암호화된 시크릿 저장, 선택적 비밀번호 보호, 시크릿이 브라우저에 전달되지 않음.
• 다중 모델 지원 – OpenAI 호환 제공자, SDK를 통한 Claude, Google Gemini, X.ai, OpenRouter, 또는 Ollama를 통해 로컬 모델을 구성 가능.
• MCP 통합 – Model-Context-Protocol(MCP) 서버에서 도구, 리소스, 프롬프트를 탐색, 설치, 호출 가능. FLUJO는 다른 MCP 호환 앱(Claude Desktop, Cursor 등)이 동일한 서버 설정을 재사용할 수 있도록 MCP 프록시 역할도 가능.
• 에이전트 빌더 –
  • 간단 모드: 일반 언어로 선형 레시피 작성.
  • 전문가 시각 모드: 캔버스에서 시작, AI, 앱, 하위 흐름, 종료 노드를 연결하고 분기, 루프, 핸드오프 도구 지원.
  • 하위 흐름: 고유한 격리된 상태를 가진 함수로 흐름을 재사용 가능.
• 라이브 디버깅 – 실행을 노드 단위로 단계별로 진행하고, 브레이크포인트를 설정하며 각 단계 전/후 상태를 검사 가능.
• 자동화 트리거 – 크론 스타일 실행, 웹훅 호출, 파일 감시, URL 감시, 주기적 MCP 도구 풀링을 지원하며, 전체 실행 기록 제공.
• 대화 UI – 어떤 에이전트와도 대화 가능, 파일/오디오 첨부, 메시지 편집, 각 단계별 토큰 사용량 확인 가능.
• OpenAI 호환 엔드포인트 – 어떤 흐름도 http://localhost:4200/v1로 노출하여 기존에 OpenAI에 연결하는 코드가 flow-<flow-name>을 호출할 수 있도록 함.
• 내장 API 문서 – 검색 가능한 /docs 페이지에서 모든 REST 엔드포인트(채팅, 흐름, MCP, 트리거 등)를 목록으로 제공.

실행 방법

1. 일클릭 설치 프로그램 – Windows 사용자는 flujo-setup.exe를 다운로드하거나 PowerShell 일문장 명령어(irm … | iex)를 실행. Linux/macOS 사용자는 curl-파이프-bash 스크립트를 실행.
2. Docker – docker compose up --build로 소스에서 이미지를 빌드하고 포트 4200에서 서비스를 시작(또한 MCP 앱용 사전 포트 4201 사용).
3. 수동 설치 – 리포지토리 복제 후 npm install (또는 yarn), 개발용으로는 npm run dev, 운영용으로는 npm run build && npm start 실행.
4. npx 단축키 – npx flujo-ai로 사전 빌드된 바이너리를 다운로드하고 복제 없이 실행.

일반적인 사용 사례

• 개인용 AI 어시스턴트 – LLM과 캘린더 도구 MCP 서버를 결합하여 회의를 자동으로 예약.
• 고객 지원 봇 – 새로운 티켓이 도착하면 웹훅으로 흐름을 트리거하고, 모델이 티켓 시스템 MCP 도구를 호출하여 응답.
• 데이터 파이프라인 오케스트레이터 – 하위 흐름과 루프를 사용해 API에서 데이터를 가져오고, 모델로 변환한 후 MCP 리소스를 통해 데이터베이스에 저장.
• 팀 협업 – 여러 에이전트를 공유된 "회의" 대화에 배치하여 브레인스토밍 또는 작업 분담 가능.
• 프로토타입 통합 – 흐름을 OpenAI 호환 엔드포인트로 노출하고 기존 코드베이스(예: VS Code 확장, 웹 앱)에서 호출 가능.

제한 사항 / 주의할 점

• 내장 인증 없음. 서버는 기본적으로 localhost에 바인딩됨. 공개적으로 노출하려면 외부 리버스 프록시와 인증이 필요.
• OpenAI 호환 엔드포인트는 흐름 호출만 지원하며, 완전한 Ollama 스타일 모델 서버는 아님.
• MCP 서버는 임의의 코드를 실행하므로 신뢰할 수 있는 서버만 설치하고 사전(포트 4201)을 격리해야 함.
• UI는 시각적이지만, 좋은 이름 지정과 문서 없이 복잡한 흐름은 유지보수가 어려울 수 있음.

더 알아보기

• 공식 사이트 및 제품 영상: https://flujo.com.co/
• README의 빠른 설치 섹션(일클릭 설치 프로그램, Docker, npx).
• 앱 실행 후 내장 /docs 페이지.
• 지원을 위한 커뮤니티 디스코드 및 GitHub Issues.

---

위 정보는 리포지토리의 README에서 직접 인용되었으며, 추가 기능은 추측되지 않았습니다.