一、上传项目到GitHub

当你完成 Streamlit AI 网站的代码编写后，默认只能在本地（localhost）运行。若想让他人通过互联网访问，需将项目部署到公网服务器。Streamlit 提供了便捷的部署流程，核心步骤包括依赖管理、代码托管（GitHub）和云部署，以下是详细指南：

1、准备项目依赖（requirements.txt）

部署前需明确项目依赖的库，确保服务器能正确安装所需环境。

生成依赖文件

在项目终端执行以下命令，自动生成包含所有依赖库的requirements.txt：

pip freeze > requirements.txt

• 说明：文件中会列出项目中直接或间接使用的所有库（包括依赖的子库），无需手动记忆或填写。

2、将项目上传到 GitHub

Streamlit 社区云部署需从 GitHub 仓库获取代码，因此需先将项目托管到 GitHub。

2.1. GitHub 注册与登录

• 访问GitHub 官网，点击右上角 “Sign up” 注册账号（已有账号直接 “Sign in”）。
• 注册流程：输入邮箱→设置密码（8 位以上，含数字 / 字母，或 15 位以上）→设置用户名（支持字母、数字、短横杠）→完成人机验证→输入邮箱验证码。

2.2. 创建代码仓库

代码仓库可理解为 “项目文件夹”，用于存放所有项目文件：

1. 登录后点击右上角 “+”→“New repository”。
2. 填写仓库信息：
   • Repository name：仓库名称（支持字母、数字、英文句号、下划线、短横杠，如ai-chat-app）。
   • Description：项目描述（可选，支持中文，如 “基于 Streamlit 的 AI 对话工具”）。
   • Visibility：选择Public（公开，便于分享）或Private（私有）。
   • Add a README file：勾选则自动创建README.md（项目说明文档，可选）。
   • .gitignore：忽略文件。初期可忽略，后续按需添加。
   • License：初期可忽略，后续按需添加。如果想要了解 不同许可证的具体含义，就可以去到chooselicense.com 这个网站。
3. 点击 “Create repository” 完成创建。

2.3. 上传项目文件

1. 进入新建仓库，点击 “Add file”→“Upload files”。
2. 拖拽项目文件（如.py代码、requirements.txt、数据文件等）到上传区域，注意排除虚拟环境文件夹（如venv）（体积大且非必要）。
3. 填写提交信息：
   • Commit changes：简短描述本次上传（如 “初始版本提交”）。
   • 可选：填写详细描述。
4. 点击 “Commit changes” 完成上传。

2.4. 后续操作

• 删除文件：进入文件→点击右上角 “...”→“Delete file”→提交确认。
• 更新文件：重新上传同名文件，自动覆盖旧版本。
• 版本控制：GitHub 基于 Git 工具，可记录每次改动历史、追踪修改人，支持回退到旧版本（团队协作必备，建议深入学习 Git）。

二、让你的AI应用能用链接访问

将项目上传到 GitHub 后，通过 Streamlit 社区云（share.streamlit.io）可免费部署应用，生成公网可访问的链接。以下是详细部署步骤：

1、登录 Streamlit 社区云

1. 访问部署平台：打开浏览器，输入网址 share.streamlit.io。
2. 登录账号：
   • 推荐点击 “Continue with GitHub”，使用 GitHub 账号登录（无需单独注册）。
   • 首次登录需授权 Streamlit 访问 GitHub 信息，点击绿色授权按钮即可。
3. 完善信息（首次登录）：按提示填写姓名、邮箱、所在国家等基本信息。

2、创建并部署应用

1. 进入主页面后，点击 “New App” 按钮，开始部署流程。
   • 若出现 GitHub 仓库访问授权提示，再次点击绿色按钮授权（仅首次需要）。
2. 填写项目信息：
   • Repository：从下拉框中选择已上传到 GitHub 的项目仓库（如your-username/ai-app）。
   • Branch：默认选择main或master分支（无需修改，除非使用了自定义分支）。
   • Main file path：填写项目主文件（即本地运行时执行streamlit run后面的文件名，如main.py）。
   • URL：自定义部署后的网址后缀（自动生成默认值，可修改为更简短的名称，绿色提示表示未被占用）。
3. 启动部署：点击 “Deploy” 按钮，开始部署流程。

3、部署过程与完成

• 部署中：页面会显示加载动画，可点击 “Manage App” 查看实时部署日志（如依赖安装过程，requirements.txt中的库会被逐一安装）。
• 完成部署：等待几分钟后，部署成功，页面会显示应用链接（如https://your-app-name.streamlit.app）。

4、使用与分享

部署成功后，任何人都可通过生成的链接访问你的应用。你可以将链接分享给他人，无需配置服务器即可实现公网访问。

通过 Streamlit 社区云，无需复杂的服务器配置，几分钟内即可完成应用部署，是快速分享 Streamlit 项目的理想选择。