Brain Beaver 🦫

What is this?

• 마크다운 파일들을 대신 읽어 주요 내용을 요약하고 키워드를 추출합니다.
• 연두색 ~ 초록색 : 임베딩/벡터유사도를 기반으로 서로 연관된 것들을 연결하고 그래프 형태로 시각화합니다.
• 빨간색 : 웹에서 검색했을 때 반대되는 의견이 있으면 그래프로 연결해서 보여줍니다.

그림1 : 노드를 선택하면 세부내용을 볼 수 있다.

그림2 : 빨간색 노드는 웹으로 검색했을 때 잘못됐을 가능성이 높은 지식이다.

Getting Started

With Docker Compose

• DB와 관련 컨테이너를 빌드하고 기동한다.

docker plugin install grafana/loki-docker-driver:latest --alias loki --grant-all-permissions
cd docker
docker compose up --build

• 파이썬 의존성을 설치, 기동

cd src/Python.FastApi
python -m venv .venv
. .venv/bin/activate
pip install -r python/requirements

# 앱 기동
OTEL_PYTHON_LOG_CORRELATION=true \
uvicorn app:app

With Aspire/AppHost

• 파이썬 의존성을 설치

cd src/Python.FastApi
python -m venv .venv
. .venv/bin/activate
pip install -r python/requirements

• AppHost를 통해 도커 및 파이썬 기동

# 개발용 SSL
cd src/Aspire.AppHost
dotnet dev-certs https --clean && dotnet dev-certs https --trust

# 도커 설정
# - sudo로 aspire 기동시 권한문제, 대신에 현재 사용자에게 docker 권한부여
sudo chown -R $USER ~/.docker
sudo chmod -R 775 ~/.docker
docker plugin install grafana/loki-docker-driver:latest --alias loki --grant-all-permissions

# AppHost 앱 기동
cd src/Aspire.AppHost
dotnet run --project Aspire.AppHost.csproj

# Python 앱 기동
# - AppHost uvicorn/dashboard는 opentelemetry 연동시 버그가 있어 9.2 이후 패치예정
OTEL_PYTHON_LOG_CORRELATION=true \
uvicorn app:app

Notice

• 그외 설정사항
  • 마크다운 데이터 경로, 모델 종류 등은 app.py에서 설정
  • OpenAI, Naver 검색 키 등은 config.properties, secret.properties에서 설정
  • secret.properties는 secret.sample.properties을 참고해 작성
  • Python 3.12, Mac M1에서 작업함. Python 3.13에서 일부 의존성 충돌 있음
  • Debian OS는 psycopg2 대신 apt 등으로 psycopg2-binary 패키지 설치 필요

앱 구조

• Dotnet.BlazorUI : 데이터소스를 입력해 데이터추출, 예상비용 확인, 결제 및 진행
• Java.SpringBFF : extract, engage, expand 기능 단위로 여러 API를 묶어서 호출
• Python.FastAPI : concepts, networks, references 도메인 기반 단편화된 API 제공
• Docker : portainer, postgresql, pgadmin 컨테이너
• Aspire.AppHost : 상기 모든 앱과 도커 컨테이너를 호스팅, 대시보드/모니터링/장애회복 기능제공
• Aspire.ServiceDefaults : 클라우드 네이티브 앱 호스팅 기본값 설정