# Pinecone

**Repository Path**: xv514/pinecone

## Basic Information

- **Project Name**: Pinecone
- **Description**: Pinecone是一个专注于高效、可扩展向量搜索的开源项目，支持大规模机器学习应用，为开发者提供快速准确的数据检索方案。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-23
- **Last Updated**: 2025-10-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基于 Pinecone 的 KNN 手写数字识别
![输入图片说明](%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202025-10-23%20131951.png)
![输入图片说明](%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202025-10-23%20132332.png)
## 项目介绍

本项目是一个使用 Pinecone 向量数据库实现手写数字识别的示例工程，主要功能包括：

* 加载手写数字数据集并上传至 Pinecone 向量数据库
* 利用 Pinecone 相似检索实现 k-NN 推理（多数投票法）
* 通过 Gradio 提供在线交互界面，支持手写数字输入与实时识别

## 安装步骤

### 环境要求
* Python 3.8+
### 依赖安装
```
\# 创建并激活虚拟环境（Windows PowerShell）
python -m venv .venv
.\\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
\# 安装依赖包
python -m pip install pinecone scikit-learn numpy tqdm gradio pillow matplotlib
```
### API 密钥配置
Pinecone 访问密钥需通过环境变量设置，不支持代码硬编码：

* 临时设置（当前会话有效）：
```
\$env:PINECONE\_API\_KEY='your-pinecone-key'
```
* 永久设置（需重启终端生效）：
```
setx PINECONE\_API\_KEY "your-pinecone-key"
```

## 使用指南
### 1. 初始化索引并上传数据
```
\$env:PINECONE\_API\_KEY='your-pinecone-key'

python pinecone\_train.py
```
### 2. 启动交互界面
```
\$env:PINECONE\_API\_KEY='your-pinecone-key'

python optimal\_knn\_webapp\_pinecone.py
```
启动后可在浏览器中访问界面，在画板上绘制数字进行识别，支持通过滑块调整 k 值（近邻数量）。

### 3. 运行查询示例
```
\$env:PINECONE\_API\_KEY='your-pinecone-key'

python pincone\_example.py
```

## 个人信息

- 学号: 202352320224
- 年级: 2023
- 专业: 智能科学与技术
- 班级: 2 班