데싸 되기

0. 목표 정의“내 컴에선 되는데?”를 없애기 위해코드 + OS + 라이브러리 + 설정을 전부 Docker 이미지로 고정한다.로컬 / 테스트 서버 / 운영 서버 어디서든docker compose up 한 방에 동일한 환경을 띄우는 것을 목표로 한다.1. 기본 원칙하나의 서비스 = 하나의 이미지FastAPI, 백엔드, 워커, DB 등은 각각 컨테이너로 분리.이미지는 불변(Immutable)컨테이너 안에 직접 pip install 하지 않고,항상 Dockerfile 변경 → docker build로 새 이미지 생성.컨테이너는 휘발성컨테이너 안에 중요한 데이터를 저장하지 않는다.데이터는 반드시 볼륨/외부 DB에 저장.환경 차이는 “환경 변수”로 제어코드/이미지는 같고, 환경별(dev/stage/prod) 설정..

아래 내용은 팀/회사 개발 환경을 안정적으로 유지하기 위한 환경 관리 모범 사례(Best Practices)를 정리한 가이드입니다.venv, conda, pyenv, Windows/Mac 환경을 모두 고려해 통합적으로 구성했습니다.환경 관리 모범 사례 가이드1. 프로젝트마다 독립된 가상환경을 반드시 구성한다프로젝트 간 패키지 충돌을 방지하고 재현성을 높인다.venv 또는 conda 중 하나를 선택해 일관되게 사용한다.가상환경 폴더는 보통 .venv/ 또는 env/로 통일한다.예시:project/ ├─ app/ ├─ .venv/ ├─ requirements.txt ├─ environment.yml └─ README.md2. 파이썬 버전과 패키지 버전을 명시적으로 관리한다“3.10”만 적지 말고 “3.10...

데이터 분석, 백엔드 개발, LLM 프로젝트를 하다 보면 “프로젝트별 파이썬 환경을 어떻게 관리해야 하지?”라는 고민이 꼭 생깁니다.특히 다른 사람과 협업해야 하거나, 재현성(Reproducibility)이 중요한 경우에는 가상환경 구조를 명확히 이해하는 것이 필수입니다.이 글에서는 Mac / Windows, venv / conda 각각에서 가상환경을 만드는 방법을 완전히 정리합니다.1. 왜 가상환경을 써야 할까?프로젝트마다 서로 다른 패키지 버전 사용 가능실험 환경을 독립적으로 유지 → 충돌 방지협업 시 재현 가능한 환경 제공시스템 파이썬을 망가뜨리지 않음2. 전체 지도환경 파이썬 버전 관리 가상환경 생성 특징macOS + venvpyenv로 버전 관리python -m venv가볍고 빠름, 기본 제공m..

1. Neo4j Docker 컨테이너 만들고 켜기1-1. 윈도우에서 준비Docker Desktop 설치 + 실행 (이미 되어 있으면 넘어가도 됨)PowerShell 열기 (예: Win + X → “Windows PowerShell”)1-2. Neo4j용 폴더 먼저 만들기 (호스트 쪽)호스트(윈도우)에서 네오4j 데이터/로그/CSV를 보관할 폴더를 하나 만들어두면 좋습니다.mkdir C:\neo4jmkdir C:\neo4j\datamkdir C:\neo4j\logsmkdir C:\neo4j\import앞으로 CSV 파일은 C:\neo4j\import에 넣으면 컨테이너 안에서 자동으로 보이게 만들 거예요!1-3. Docker로 Neo4j 컨테이너 생성 + 실행PowerShell에서 아래 명령 한 번만 실행하..

LangGraph + LangSmith를 실전에서 더 잘 활용하기 위한 고급 기능들을 소개하겠습니다.각 노드 트레이스 명시, 로그 삽입, 평가(Eval)까지 한 번에 정리해드릴게요.✅ 1. 각 노드별 LangSmith trace 명시 방법LangGraph에서는 노드를 등록할 때 LangChain의 Runnable 객체 또는 @traceable로 감싼 함수를 사용할 수 있어요.📌 방법 A. 노드 함수에 @traceable 붙이기from langsmith import traceable@traceable(name="RefineQueryNode", run_type="chain")def refine_query(state: dict) -> dict: # 프롬프트 정제 로직 refined = f"정제된 ..

LangGraph가 LangChain과 LangSmith를 자동 통합하기 때문에 따로 @traceable 표기할 필요 없음✅ 왜 @traceable 없어도 LangSmith에 기록될까?LangGraph는 내부적으로 LangChain 객체(LLM, Retriever 등)를 사용하며, LangSmith와 통합된 상태에서는 graph 내의 각 노드 실행 결과를 자동으로 trace합니다.result = await graph_app.ainvoke( lg_input, config={ "configurable": { "thread_id": f"{request.session_id}_{request.question_user_id}" }, "run_nam..

📦 0. 설치 및 환경 설정pip install -U langsmith langchain openai python-dotenv.env 파일 또는 코드에서 다음 환경 변수를 설정하세요:LANGCHAIN_TRACING_V2=trueLANGSMITH_TRACING=trueLANGCHAIN_API_KEY=YOUR_LANGSMITH_API_KEYLANGCHAIN_PROJECT=MyProjectName # 지정하지 않으면 default 프로젝트에 저장됩니다LANGCHAIN_ENDPOINT=https://api.smith.langchain.com세팅이 완료되면 tracing이 자동 활성화됩니다 (Analytics Vidhya, Reddit, docs.smith.langchain.com).🧩 1. OpenAI 호..

LLM 기반 애플리케이션을 개발할 때 디버깅·모니터링·평가를 한곳에서 해결해주는 플랫폼, LangSmith를 소개합니다.🔎 1. LangSmith란?서비스명: LangSmith출시 배경: LangChain 팀이 개발한 LLM 앱 관찰·평가 플랫폼 (docs.smith.langchain.com, docs.smith.langchain.com)핵심 기능:Tracing / Observability – LLM 호출, 체인, 에이전트 실행을 자동으로 기록Evaluations (Evals) – 실 운영 데이터를 기반으로 자동 및 사용자 평가Prompt Engineering 툴 – 프롬프트 버전 관리, Playground, 협업 기능🌟 2. LangSmith가 왜 특별한가?기존 ChatGPT나 Claude와 비교했..

🔍 1. PromptPerfect무엇인가? 다양한 LLM(예: GPT‑4, Claude, Midjourney 등)의 프롬프트를 즉시 최적화해주는 자동화 툴 (eWEEK, promptperfect.jina.ai)차별점 3가지즉각 리파인: 입력 프롬프트를 곧바로 더 정교하고 깔끔하게 개선다중 모델 대응: 텍스트와 이미지 모델 모두 지원쉬운 사용성: CLI, 웹 UI 모두 제공사용법웹에서 초안 입력 →대상 모델 선택 → 최적화된 프롬프트 자동 생성 →복사해서 AI 도구에 붙여넣기무료 체험 가능, 월 $19.99부터 유료 (eWEEK)추천 대상 & 용도콘텐츠 제작자, 마케터: 메시지를 더 정교하게 다듬고 싶을 때🔍 2. Vertex AI Prompt Optimizer (Google)무엇인가? Vertex A..

🔍 1. OpenAI Playground무엇인가? OpenAI의 공식 웹 기반 IDE로, GPT‑3.5/4/4o 모델에 직접 프롬프트를 입력해 실험할 수 있는 서비스 (위키피디아)차별점 세 가지즉시 피드백: 온갖 파라미터(temperature, max tokens 등)를 실시간으로 조정하며 결과 확인 가능모델 다양성: 여러 모델버전을 선택해 비교 테스트 가능공유 기능: 링크로 프롬프트 세팅을 팀원과 쉽게 공유 (Reddit, Dev Learning Daily, Openxcell)사용법OpenAI 계정으로 로그인 → Playground 접속 → 모델/파라미터 설정 → 프롬프트 입력 → 실행프로토타이핑 무료, API 연동은 별도시장 반응“개발자들이 빠른 실험에 선호하는 도구”라는 평 다수 (Reddit)추..