개발/Langflow

[Langflow] Lanflow 설치하기

말하는 알감자 2025. 12. 16. 11:36

1. LangFlow란?

LangFlow는 오픈소스, Python 기반의 AI 애플리케이션 구축 프레임워크입니다.

다음과 같은 특징을 공식적으로 지원합니다.

  • 특정 LLM에 종속되지 않음
  • 특정 Vector Store에 종속되지 않음
  • Agent 기능 지원
  • MCP(Model Context Protocol) 지원
  • 시각적 에디터 기반 워크플로우 설계

1.1 LangFlow의 핵심 목적

  • AI 애플리케이션의 워크플로우를 빠르게 설계
  • 복잡한 로직을 시각적으로 구성
  • 실시간 테스트를 통해 빠른 프로토타이핑
  • 완성된 Flow를 API 또는 서버 형태로 제공

1.2 주요 개념 정리

① Flow

  • 하나의 AI 애플리케이션 워크플로우
  • 여러 컴포넌트(Component)로 구성
  • LangFlow의 가장 핵심적인 단위

② Component

  • 워크플로우의 단일 처리 단계
  • 노드(Node) 형태로 연결됨

대표적인 컴포넌트 예시

  • Input / Output
  • Prompt
  • LLM
  • Agent
  • Tool
  • Vector Store
  • Embedding Provider

각 컴포넌트는 설정 가능한 파라미터를 가짐

1.3 시각적 에디터

LangFlow는 Drag & Drop 방식의 시각적 에디터를 제공합니다.

가능한 작업:

① 컴포넌트 선택

② 노드 연결

③ 파라미터 설정

④ 즉시 실행 및 테스트

이를 통해 코드 작성 없이도 워크플로우 구조를 빠르게 확인 가능

1.4 실시간 테스트 (Playground)

LangFlow는 Playground 기능을 제공합니다.

Playground에서 가능한 작업:

  • 전체 Flow 실행 테스트
  • 개별 컴포넌트 단독 실행
  • 의존성 문제를 단계별로 검증

→ 전체 애플리케이션을 만들기 전에 로직 검증 가능

1.5 Flow 실행 및 활용 방식

LangFlow에서 만든 Flow는 다음 방식으로 활용할 수 있습니다.

① 프로토타입 용도

  • 아이디어 검증
  • 로직 테스트

② API 연동

  • LangFlow API를 통해 Flow 호출
  • 외부 애플리케이션에 임베드 가능

③ 서버 배포

  • LangFlow 서버 실행
  • 퍼블릭 인터넷 제공 가능
  • Docker 컨테이너 배포 지원

1.6 컴포넌트 확장성

LangFlow는 기본 컴포넌트 외에도 확장을 지원합니다.

  • 외부에서 만든 커스텀 컴포넌트 사용 가능
  • Python으로 직접 커스텀 컴포넌트 개발 가능
  • 개인용 또는 공유용 컴포넌트 제작 가능

1.7 Agent 및 MCP 지원

LangFlow는 공식적으로 다음 기능을 지원합니다.

  • LangFlow Agent 사용
  • Flow를 Agent Tool로 사용
  • LangFlow를 MCP 서버로 사용
  • LangFlow를 MCP 클라이언트로 사용

→ Agent 중심 AI 애플리케이션 구축 가능

1.8 활용 가능한 AI 애플리케이션 예시

공식 문서 기준으로 LangFlow는 다음과 같은 애플리케이션에 활용 가능합니다.

  • 챗봇
  • 문서 분석 시스템
  • 콘텐츠 생성기
  • Agent 기반 애플리케이션

2. LangFlow 설치 방법

LangFlow는 총 4가지 방식으로 설치할 수 있습니다.

설치 방식에 따라 목적과 사용 환경이 다릅니다.

자세한 설치 방법이 궁금하다면 다음 링크를 참조해주세요

https://docs.langflow.org/get-started-installation

설치 방식

설치 방식 설명 특징

LangFlow Desktop 데스크톱 앱 형태 가장 간단한 설치
Docker 컨테이너 실행 환경 격리
Python 패키지 (OSS) Python 라이브러리 설치 환경 제어 가능
소스 코드 설치 GitHub 소스 사용 기여 목적

※ 모든 로컬 설치 방식은 회원가입·로그인 없이 사용 가능

2.1 LangFlow Desktop (권장)

개요

  • LangFlow를 데스크톱 애플리케이션으로 설치
  • 의존성 관리 및 업그레이드가 자동으로 처리됨
  • 가장 설정이 단순한 방식

특징

  • 일부 기능 미지원
  • (Shareable Playground, Voice Mode 등)

지원 환경

  • macOS 13 이상
  • Windows 지원

설치 절차 (macOS 기준)

1. LangFlow Desktop 페이지 접속 (Langflow 홈페이지 : https://www.langflow.org/)

2. Get Started for Free 클릭

 

3. 연락처 정보 입력 후 다운로드

company의 경우는 그냥 다니는 대학 검색해서 넣었습니다.

4. 애플리케이션 설치

본인 컴퓨터에 맞는 것으로 골라서 다운로드 받습니다.

저는 맥북 유저니까 macOS(Apple Siicon)을 다운받습니다.

5. LangFlow 실행

continue를 클릭하면 다운로드가 시작됩니다.

설치 완료 후 화면

6. create first flow 클릭

2.2 Docker로 설치

개요

  • LangFlow를 Docker 컨테이너로 실행
  • 실행 환경을 완전히 분리 가능

특징

  • 회원가입 / 로그인 불필요
  • 서버 및 배포 환경에 적합

설치 및 실행

docker run -p 7860:7860 langflowai/langflow:latest

접속 주소

<http://localhost:7860/>

2.3 LangFlow OSS Python 패키지 설치

개요

  • Python 환경에 LangFlow를 직접 설치
  • 환경·버전·의존성을 직접 제어 가능

필수 조건

  • Python 버전
    • macOS / Linux: 3.10 ~ 3.13
    • Windows: 3.10 ~ 3.12
  • uv 설치 필요

권장 시스템 사양

  • 최소: Dual-core CPU, RAM 2GB
  • 권장: Multi-core CPU, RAM 4GB 이상

설치

uv pip install langflow

특정 버전 설치:

uv pip install langflow==1.4.22

실행

uv run langflow run

접속 주소

<http://127.0.0.1:7860>

 

2.4 소스 코드에서 설치

개요

  • LangFlow GitHub 소스를 직접 사용
  • LangFlow 코드 또는 문서에 기여하기 위한 방식

특징

  • 일반 사용 목적에는 권장되지 않음
  • 개발자 및 기여자 대상

설치 방식 선택 정리

  • 처음 사용 → LangFlow Desktop
  • 서버·배포 환경 → Docker
  • 개발·커스터마이징 → Python 패키지
  • 기여 목적 → 소스 코드 설치

'개발 > Langflow' 카테고리의 다른 글

[Langflow] Langflow API Key 생성  (1) 2025.12.17
[Langflow] OpenAI API key 생성  (0) 2025.12.16