# AiStudyProject

**Repository Path**: codeyumlee/AiStudyProject

## Basic Information

- **Project Name**: AiStudyProject
- **Description**: Ai学习项目
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-20
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AiStudyProject

AI学习项目 - 简单实用的深度学习实验平台

## 项目简介

这是一个简洁的AI学习项目，用于个人学习和实验。项目结构简单清晰，专注于代码实践而非复杂工程。

## 项目结构

```
AiStudyProject/
├── src/                   # 原始代码存放
├── examples/              # 示例代码
│   ├── 01_basics.py      # PyTorch基础（张量、自动求导）
│   ├── 02_model.py       # 神经网络模型定义
│   └── 03_training.py    # 训练循环示例
├── notebooks/             # Jupyter实验笔记本
├── data/                  # 数据存放目录
├── checkpoints/           # 模型保存目录
├── config.py             # 配置文件
├── utils.py              # 工具函数
├── requirements.txt      # 依赖列表
└── README.md
```

## 快速开始

### 1. 创建虚拟环境

```bash
python3 -m venv venv
source venv/bin/activate  # Linux/Mac
# 或 venv\Scripts\activate   # Windows
```

### 2. 安装依赖

```bash
pip install -r requirements.txt
```

### 3. 运行示例

```bash
# 运行基础示例
python examples/01_basics.py

# 运行模型示例
python examples/02_model.py

# 运行训练示例
python examples/03_training.py
```

### 4. 使用Jupyter

```bash
jupyter notebook notebooks/
```

## 学习路线

1. **01_basics.py** - 学习PyTorch基础
   - 张量创建和操作
   - 自动求导机制
   - 设备管理（CPU/GPU）

2. **02_model.py** - 学习模型定义
   - 全连接神经网络
   - 卷积神经网络
   - 模型组件（层、激活函数等）

3. **03_training.py** - 学习模型训练
   - 数据加载
   - 训练循环
   - 模型保存与加载

## 常用命令

```bash
# 设置随机种子（保证可重现）
python -c "from utils import set_seed; set_seed(42)"

# 查看配置
python config.py

# 测试工具函数
python utils.py
```

## 依赖说明

| 包名 | 用途 |
|-----|------|
| torch | 深度学习框架 |
| numpy | 数值计算 |
| matplotlib | 数据可视化 |
| jupyter | 交互式开发 |

## 注意事项

- `data/` 目录用于存放数据集，不会被Git跟踪
- `checkpoints/` 目录保存训练的模型，不会被Git跟踪
- 建议使用虚拟环境隔离项目依赖

## 许可证

MIT License