Flowise 설치 & 실행

Flowise 설치

✔ Step 1-1. Node.js 설치

1) 다운로드 링크
: https://nodejs.org/en/download/prebuilt-installer

2) 설치 중 옵션 그대로 두고 Next

3) 설치 후 버전 확인 → 숫자만 나오면 성공

> node -v
> npm -v

✔ Step 1-2. Flowise 설치

1) Flowise 설치

> npm install -g flowise

2) 설치 완료시

> flowise start

3) 브라우저에서 자동으로 열리면 성공

> http://localhost:3000

2025-11-19 17:38:16 [INFO]: Starting Flowise...
2025-11-19 17:38:16 [INFO]: 📦 [server]: Data Source initialized successfully
2025-11-19 17:38:17 [INFO]: 🔄 [server]: Database migrations completed successfully
2025-11-19 17:38:17 [INFO]: 🔐 [server]: Identity Manager initialized successfully
2025-11-19 17:38:25 [INFO]: 🔧 [server]: Nodes pool initialized successfully
2025-11-19 17:38:25 [INFO]: ⏹️ [server]: Abort controllers pool initialized successfully
2025-11-19 17:38:25 [INFO]: 🔑 [server]: Encryption key initialized successfully
2025-11-19 17:38:25 [INFO]: 🚦 [server]: Rate limiters initialized successfully
2025-11-19 17:38:25 [INFO]: 💾 [server]: Cache pool initialized successfully
2025-11-19 17:38:25 [INFO]: 📊 [server]: Usage cache manager initialized successfully
2025-11-19 17:38:25 [INFO]: 📈 [server]: Telemetry initialized successfully
2025-11-19 17:38:25 [INFO]: 🌊 [server]: SSE Streamer initialized successfully
2025-11-19 17:38:25 [INFO]: 🎉 [server]: All initialization steps completed successfully!
2025-11-19 17:38:25 [INFO]: ⚡️ [server]: Flowise Server is listening at :3000
2025-11-19 17:39:26 [INFO]: ⬆️ POST /api/v1/auth/resolve
2025-11-19 17:41:32 [INFO]: ⬆️ POST /api/v1/account/register
2025-11-19 17:41:33 [INFO]: ⬆️ POST /api/v1/auth/login

(참고) 에러 발생시 원인 및 해결 방안

C:\Users\Administrator>flowise start
 »   ModuleLoadError: [MODULE_NOT_FOUND] require failed to load
 »   C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\dist\c
 »   ommands\start.js: Cannot find module 'turndown'
 »   Require stack:
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\node
 »   _modules\flowise-components\dist\src\utils.js
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\node
 »   _modules\flowise-components\dist\src\index.js
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\dist
 »   \utils\index.js
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\dist
 »   \index.js
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\dist
 »   \commands\start.js
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\node
 »   _modules\@oclif\core\lib\module-loader.js
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\node
 »   _modules\@oclif\core\lib\config\plugin.js
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\node
 »   _modules\@oclif\core\lib\config\config.js
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\node
 »   _modules\@oclif\core\lib\config\index.js
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\node
 »   _modules\@oclif\core\lib\command.js
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\node
 »   _modules\@oclif\core\lib\index.js
 »   - C:\Users\Administrator\AppData\Roaming\npm\node_modules\flowise\bin\
 »   run
 »   Code: MODULE_NOT_FOUND

• 에러 원인 : Flowise 설치 자체는 됐는데, 내부에서 쓰는 turndown 모듈이 누락되어 있어서 flowise start가 크래시 난 상황
• 조치 방법
  • 1단계: 누락된 turndown 모듈 설치
    • npm install -g turndown
    • flowise start
  • 2단계: 혹시 이번엔 langchainhub 에러가 뜨는 경우
    • npm install -g langchainhub
    • flowise start
  • 3단계: 그래도 안 되면 (플랜 B – 안정 버전으로 재설치)
    • 기존 Flowise 제거
      • npm uninstall -g flowise
    • 안정 버전(예: 3.0.7)으로 재설치
      • npm install -g flowise@3.0.7
    • 다시 실행
      • flowise start

✔ Step 1-3. USERNAME 및 PASSWORD 설정

✔ Step 1-4. 프로젝트 전용 폴더 만들기

C:\audit_ai_project\
   ├─ data\			→ Flowise 저장 DB, 설정 등이 여기에 저장됨
   ├─ documents\	→ 감사보고서 PDF가 들어가는 폴더
   ├─ graphrag\
   ├─ vector_db\
   ├─ streamlit\

(참고) 각 폴더의 용도

• data : Flowise 자체가 사용하는 내부 데이터
  • SQLite DB
  • 세션, workflow, node 설정
  • 파일 로더 캐시
  • 로그인/계정 정보
• documents
  • PDF / 감사보고서 / Word 파일 / 텍스트 등을 넣고 Flowise에서 불러오면 RAG 구축 가능
• graphrag : GraphRAG 관련 코드 또는 노드 제작 시 활용할 코드
  • NER 스크립트
  • 엔티티 추출 요약 로그
  • Neo4j 스키마
  • 관계 매핑 코드
  • GraphRAG 테스트 파일
• vector_db
  • Chroma DB
  • Milvus DB(옵션)
  • Faiss 인덱스
  • Flowise에서 임베딩 저장 위치
• streamlit : 평가/데모/최종 보고서용
  • Streamlit 기반 UI
  • FastAPI 서버와 연동할 수도 있음
  • GraphRAG & RAG 모델 호출 코드

✔ Step 1-5. Flowise를 이 폴더 기반으로 실행하기

> cd C:\Users\Administrator\Desktop\audit_ai_project\data

> flowise start --FLOWISE_USERNAME=admin --FLOWISE_PASSWORD=abcd1234!

> http://localhost:3000

이제 Flowise는 flowise_data 폴더 안에 DB를 생성하고 모든 설정이 이 프로젝트 폴더에 저장됨.