)
如何快速上手 Generative AI for Beginners开发环境搭建一步到位Azure OpenAI/OpenAI/本地离线任选【免费下载链接】generative-ai-for-beginners21 Lessons, Get Started Building with Generative AI项目地址: https://gitcode.com/GitHub_Trending/ge/generative-ai-for-beginnersGenerative AI for Beginners是一门面向初学者的 21 节生成式 AI 实战课程从大模型概念讲起到用 Python / TypeScript 构建文本生成、聊天、图像生成等真实应用。本教程带你 10 分钟完成开发环境搭建——云GitHub Codespaces、本地Python / Docker任选模型供应商 Azure OpenAI、OpenAI、本地离线方案随心切换全程不踩依赖坑。3 种运行方式1 张表选对动手前先花 30 秒看清自己适合哪条路方案适合谁安装量环境一致性☁️ 云GitHub Codespaces零基础、Chromebook / 公司电脑零安装✅ 最高️ 本地 A原生 Python 虚拟环境熟悉命令行的开发者Python 依赖中等 本地 BDocker Dev Container追求可复现环境的工程师Docker Desktop 插件✅ 与云环境完全一致三条路最终都通向同一批课程代码可随时切换。官方说明分别在 00-course-setup/01-setup-cloud.md 与 00-course-setup/02-setup-local.md。云方案 3 步跑通零安装、免折腾Step 1Fork 仓库。点击仓库右上角 Fork 按钮把课程复制到你自己的账号之后才能随意改代码、交作业。Step 2一键创建 Codespace。在你的 Fork 中点Code → Codespaces → Create codespace on main浏览器版 VS Code 随即打开内置开发容器预装 Python 3、Node.js、.NET、Java首次构建约 2 分钟。Step 3安全地存 API 密钥。推荐用 Codespaces Secrets不落地、不进代码库⚙️ 齿轮图标 → Command Palette →Codespaces: Manage user secret→Add a new secret名称填OPENAI_API_KEY值粘贴你的密钥保存即可课程代码会自动读取。 每月免费额度为120 核时 / 60 GB 时用完前记得Stop Codespace别让闲置实例白白消耗配额。本地方案 A原生 Python 虚拟环境最快路径前置工具清单终端里逐个验证python --version、git --version工具版本要求Python3.10Git最新版VS Code可选强烈推荐四步走# 1. 克隆课程仓库 git clone https://gitcode.com/GitHub_Trending/ge/generative-ai-for-beginners cd generative-ai-for-beginners # 2. 创建并激活虚拟环境 python -m venv .venv source .venv/bin/activate # macOS / Linux # .\.venv\Scripts\activate # Windows PowerShell # 3. 一键安装全部依赖 pip install -r requirements.txt提示符前出现(.venv)前缀说明你已进入隔离环境。依赖清单 requirements.txt 包含openai、python-dotenv、tiktoken、azure-ai-inference等课程必需库版本均已锁定。进阶若你偏爱 Conda 管理多环境00-course-setup/README.md 提供了 Miniconda 的environment.yml配置法一条conda env create同样搞定。本地方案 BDocker Dev Container 环境永不漂移仓库根目录自带 .devcontainer 配置——与云 Codespace完全同构的通用运行时彻底杜绝我电脑上能跑的玄学问题。安装 Docker Desktop确认docker --version可用VS Code 安装Remote – Containers扩展File → Open Folder打开课程目录VS Code 检测到.devcontainer/会主动弹窗点Reopen in Container首次构建镜像约 3 分钟终端提示符出现即进入容器。⚠️ 二选一同一项目里 venv 和容器别同时激活否则 VS Code 会反复弹重新打开提示。选对 LLM 供应商Azure OpenAI / OpenAI / 本地离线任选课程的练习文件用文件名前缀标注了所需供应商配置谁就能跑谁全部可选配前缀供应商说明aoai-Azure OpenAI企业级合规需申请访问oai-OpenAI API注册即用githubmodels-Microsoft Foundry Models一个端点调用 OpenAI、Meta、Mistral、Cohere 等数百个模型GitHub Models 将于 2026 年 7 月底退役由它接替完整对比注册成本、API Key 获取位置、Playground 支持见 00-course-setup/03-providers.md。API 密钥安全配置.env 文件 5 分钟搞定 铁律密钥永远不写进代码。课程已提供模板 .env.copy两步生成你的私有配置cp .env.copy .env # Windows: copy .env.copy .env打开.env按所用供应商填写对应变量其余留空即可变量用途OPENAI_API_KEYOpenAI API 密钥AZURE_OPENAI_API_KEY/AZURE_OPENAI_ENDPOINTAzure OpenAI 密钥与端点AZURE_OPENAI_DEPLOYMENT对话模型部署名官方推荐gpt-4o-miniAZURE_OPENAI_EMBEDDINGS_DEPLOYMENT向量模型推荐text-embedding-3-smallAZURE_INFERENCE_ENDPOINT/AZURE_INFERENCE_CREDENTIALMicrosoft Foundry 项目端点与密钥.env已在.gitignore中不会被误提交。Python 脚本通过python-dotenv的load_dotenv()自动加载零额外配置。跑通第一个示例眼见为实以第 06 课文本生成为例在 VS Code 终端执行cd 06-text-generation-apps/python python oai-app.py # 或 aoai-app.py取决于你配置的供应商看到The capital of France is Paris——恭喜环境搭建正式毕业想改交互体验打开 06-text-generation-apps/python/oai-app.py 边读边跑。本地离线运行Foundry Local 与 Ollama不想用任何云服务课程同样支持完全离线Foundry Local微软端侧运行时自动选择 NPU / GPU / CPU 最优执行路径并暴露OpenAI 兼容端点——课程代码几乎原样复用。安装Windowswinget install Microsoft.FoundryLocalmacOSbrew install microsoft/foundrylocal/foundrylocal。Ollama本地跑 Llama、Phi、Mistral、Gemma 等开源模型的主流工具。两者都无需云订阅、无需 API Key。动手示例见 19-slm/README.md第 19 课用小型语言模型构建。5 个常见报错1 分钟自查症状解法python: command not found把 Python 加入 PATH或重开终端ModuleNotFoundError: dotenv虚拟环境没激活重跑pip install -r requirements.txtOpenAI 返回401 UnauthorizedOPENAI_API_KEY填错或已过期Docker 构建报No space leftDocker Desktop → Settings → Resources 调大磁盘Notebook 无内核Notebook 菜单 →Kernel → Select Kernel → Python 3环境搭好了下一步学什么按 README.md 的课程目录从 01-introduction-to-genai/README.md 开始21 节逐层递进概念课Learn与实战课Build穿插每节均含 Python / TypeScript 双版本示例与延伸阅读。遇到具体课程的代码目录如 06-text-generation-apps/先读它的 README再运行python/或typescript/下的样例即可。 一句话总结选一条路云 / 本地 / 离线→ 配一个.env→ 跑第一个oai-app.py你的生成式 AI 开发之路就正式出发了。【免费下载链接】generative-ai-for-beginners21 Lessons, Get Started Building with Generative AI项目地址: https://gitcode.com/GitHub_Trending/ge/generative-ai-for-beginners创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考