# AI-Agent-Container

**Repository Path**: OpenCloudOS/ai-agent-container

## Basic Information

- **Project Name**: AI-Agent-Container
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-03-31
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 🚀 OC9 AI 容器镜像共建

**OpenCloudOS 9 × 主流 AI/AI Agent 框架容器镜像适配仓库**

[![OpenCloudOS](https://img.shields.io/badge/OpenCloudOS-9-blue?style=flat-square)](https://www.opencloudos.org/)
[![License](https://img.shields.io/badge/License-Apache_2.0-green?style=flat-square)](./LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](https://gitee.com/OpenCloudOS/ai-agent-container/pulls)
[![Gitee](https://img.shields.io/badge/Gitee-ai--agent--container-red?style=flat-square&logo=gitee)](https://gitee.com/OpenCloudOS/ai-agent-container)

</div>

---

>本仓库用于社区贡献者提交**基于 OpenCloudOS 9 的 AI / AI Agent 容器镜像**。您可以挑选感兴趣的项目，为其编写基于 OpenCloudOS 9 的 Dockerfile 和容器镜像，并通过 PR 提交适配成果。
>


## 📖 目录

- [参与贡献前必读](#参与贡献前必读)
- [仓库结构](#仓库结构)
- [贡献流程](#贡献流程)
- [适配框架清单](#适配框架清单)

## 参与贡献前必读

### 环境要求

| 项目 | 要求 |
|------|------|
| 构建工具 | Docker（≥ 20.10）或 Buildah / Podman |
| Python | ≥ 3.11（推荐 3.11） |
| CUDA | 推荐 12.8（GPU 场景，非 GPU 可忽略） |
| 硬件 | CPU 镜像无特殊要求；GPU 镜像需 NVIDIA GPU |

### Dockerfile 规范

不同类型的框架使用不同的基础镜像：

| 场景 | 基础镜像 | 适用框架 |
|------|---------|---------|
| **纯 Python / CPU** | `opencloudos/opencloudos9-minimal:latest` | LangChain、CrewAI、Dify、FastGPT 等 |
| **需要 GPU / CUDA** | `opencloudos/opencloudos9-cuda-devel:12.8` | vLLM、DeepSpeed、TensorRT-LLM、PyTorch 等 |


> 详细硬件要求和 Dockerfile 规范请阅读 👉 [CONTRIBUTING.md](./CONTRIBUTING.md)

## 仓库结构

```
ai-agent-container/
├── README.md                       # 本文件
├── CONTRIBUTING.md                  # 贡献指南（详细版）
├── FRAMEWORKS.md                    # 可适配的 AI 框架完整清单
├── LICENSE
└── frameworks/                      # 各框架适配目录（按 PR 提交）
    ├── vllm/
    │   ├── Dockerfile
    │   ├── README.md
    │   └── test/
    ├── langchain/
    │   └── ...
    └── ...
```

## 贡献流程

> 详细规范请阅读 👉 [CONTRIBUTING.md](./CONTRIBUTING.md)

### 快速上手（4 步完成）

**① Fork & Clone**

```bash
git clone https://gitee.com/<你的用户名>/ai-agent-container.git
cd ai-agent-container
```

**② 创建框架适配目录**

```bash
mkdir -p frameworks/vllm/
```

**③ 编写 Dockerfile & 验证**

```bash
# 构建镜像
docker build -t oc9-vllm:0.19.0 frameworks/vllm/

# 运行基础验证
docker run --rm --gpus all oc9-vllm:0.19.0 python3.11 -c "import vllm; print(vllm.__version__)"
```

**④ 提交 PR**

```bash
git checkout -b feat/add-vllm
git add frameworks/vllm/
git commit -m "feat: add vllm v0.19.0 container image for OC9"
git push origin feat/add-vllm
# 在 Gitee 上发起 Pull Request
```

### PR 提交要求

每个 PR **必须包含**：

| 文件 | 说明 |
|------|------|
| `frameworks/<框架名>/Dockerfile` | 基于 OC9 基础镜像（minimal、cuda-devel 或其他） |
| `frameworks/<框架名>/README.md` | 框架简介、版本、构建命令、使用示例、已知问题 |
| `frameworks/<框架名>/test/` | 至少一个基础功能验证脚本、运行成功截图 |

### 验收标准

- ✅ 基于 OpenCloudOS 9 基础镜像构建成功（`opencloudos9-minimal` `opencloudos9-cuda-devel` 或其他）
- ✅ 可正常运行
- ✅ GPU 镜像需验证 CUDA 驱动兼容性（如适用）
- ✅ Dockerfile 规范，无硬编码密钥或个人信息
- ✅ README 文档完备
- ✅ 包含 test.sh 和运行成功截图

## 适配框架清单

> 完整清单（含各版本号、开源地址）请查看 👉 **[FRAMEWORKS.md](./FRAMEWORKS.md)**


### 如何选择？

- **新手推荐**：从 LangChain、ChromaDB、Open WebUI 等纯 Python 项目入手
- **进阶推荐**：vLLM、Dify、CrewAI 等核心生态项目
- **高挑战**：DeepSpeed、Megatron-LM、TensorRT-LLM 等 GPU 优化项目

## 联系我们

- **Issue 反馈**：[提交 Issue](https://gitee.com/OpenCloudOS/ai-agent-container/issues)
- **交流群**：有问题欢迎加群交流

TBD

## 许可证

本项目采用 [Apache License 2.0](./LICENSE) 许可证。