TinyEngram

环境要求

• 已安装 conda（Miniconda/Anaconda），可用 conda create 创建环境
• Python 3.10（README 指定 python=3.10）
• pip 可用并能联网安装 requirements.txt 中的依赖
• 训练/视觉复现需要 CUDA 环境，具体版本见 doc/reproduction/environment.md

安装与启动步骤

1. 1创建 conda 环境

   用 Python 3.10 新建名为 tinyengram 的独立环境，-y 表示自动确认，避免污染系统环境。

   conda create -n tinyengram python=3.10 -y

   复制

2. 2激活环境

   切换到刚创建的环境，后续所有安装与命令都要在该环境下执行。

   conda activate tinyengram

   复制

3. 3升级 pip

   先把 pip 升到较新版本，减少安装 requirements.txt 时的依赖解析问题。

   pip install --upgrade pip

   复制

4. 4安装项目依赖

   在仓库根目录执行，安装 README 提供的固定依赖文件；网络慢可加国内镜像源。

   pip install -r requirements.txt

   复制

5. 5查看环境与复现文档

   README 提示 CUDA 注意事项与可选评估依赖都写在这里，按需补齐后再跑实验。

   cat doc/reproduction/environment.md

   复制

如何确认成功

无报错装完 requirements.txt，conda activate tinyengram 后可正常导入依赖，即环境就绪；README 未给出更多启动验证方式。

常见问题

注意事项

• 这是研究/复现型项目，README 只提供环境安装步骤，未给出统一的启动或推理命令，训练与实验请结合 doc/reproduction/environment.md 与 doc/experiments 下的实验报告。
• 依赖已固定在 requirements.txt 中，不要随意升级 torch 等核心包版本，以免破坏 pinned 依赖兼容性。
• LoRA/PEFT 微调与 Stable Diffusion 视觉实验对显存有要求，建议在带 CUDA 的 GPU 机器上操作。
• 安装与实验过程较长，建议在 tmux 或 nohup 中执行，避免 SSH 断开导致中断。