# langchain-langgraph-demo

**Repository Path**: study_llm/langchain-langgraph-demo

## Basic Information

- **Project Name**: langchain-langgraph-demo
- **Description**: langchain1.0 + langgraph1.0 官网入门示例
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-12
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LangChain Demo Project

本项目用于演示 LangChain 的核心功能，包括与 Ollama 本地大模型的集成、RAG（检索增强生成）流程、向量数据库操作等。

## 🛠️ 常用工具操作指南

### ⚡ UV (Ultra-fast Python Package Installer)

`uv` 是一个极速的 Python 包管理器，用于替代 pip、pip-tools 和 virtualenv。

#### 1. 初始化与安装
- **初始化项目**: `uv init`
- **创建虚拟环境**: `uv venv` (默认创建在 `.venv` 目录)
- **激活虚拟环境**:
  - Windows: `.venv\Scripts\activate`
  - Linux/Mac: `source .venv/bin/activate`

#### 2. 依赖管理
- **安装依赖**: `uv pip install <package_name>`
  - 示例: `uv pip install langchain`
- **安装 `pyproject.toml` 中的所有依赖**: `uv sync`
- **添加依赖到 pyproject.toml**: `uv add <package_name>`
- **移除依赖**: `uv remove <package_name>`
- **查看已安装包**: `uv pip list`

#### 3. 运行脚本
- **直接运行**: `uv run <script.py>` (会自动使用虚拟环境)

---

### 🦙 Ollama (Local LLM Runner)

Ollama 用于在本地轻松运行大语言模型（如 Llama 3, DeepSeek, Mistral 等）。

#### 1. 模型管理
- **拉取模型**: `ollama pull <model_name>`
  - 示例: `ollama pull deepseek-r1:1.5b`
  - 示例: `ollama pull nomic-embed-text` (Embedding 模型)
- **查看已下载模型**: `ollama list`
- **删除模型**: `ollama rm <model_name>`

#### 2. 运行与交互
- **运行模型（交互模式）**: `ollama run <model_name>`
  - 示例: `ollama run deepseek-r1:1.5b`
- **API 服务**: Ollama 默认在后台运行 API 服务，监听 `http://localhost:11434`。

#### 3. 常用模型推荐
- **对话模型**: `llama3`, `deepseek-coder`, `mistral`
- **Embedding 模型**: `nomic-embed-text`, `all-minilm`

---

## 🚀 快速开始

1. 确保已安装 Ollama 并拉取了必要的模型：
   ```bash
   ollama pull deepseek-r1:1.5b
   ollama pull nomic-embed-text
   ```

2. 克隆本项目：
   ```bash
   git clone https://gitee.com/study_llm/langchain-langgraph-demo.git
   cd langchain-langgraph-demo
   ```

3. 安装 Python 依赖：
   ```bash
   uv pip install .
   ```

4. 运行示例代码：
   ```bash
   python demo/01-hello-ollama.py
   ```
---

### 🐘 PostgreSQL（Windows）常用操作

#### 1. 安装与服务管理
- 安装：从官方下载安装程序（默认端口 `5432`），记住安装目录如 `C:\Program Files\PostgreSQL\18\`。

#### 2. 使用 psql 连接
- 进入交互终端：`psql -U postgres -h localhost -p 5432`
- 基本命令：
  - 列出数据库：`\l`
  - 连接数据库：`\c langchain_demo`
  - 列出表：`\dt`
  - 查看表结构：`\d <table>`
  - 退出：`\q`