openeuler/codetrans

OPEA CodeTrans Docker镜像文档

镜像概述与主要用途

OPEA（Open Platform for Enterprise AI）Docker镜像是由openEuler CloudNative SIG维护的官方镜像，基于openEuler构建，用于创建开放、多提供商、健壮且可组合的生成式AI解决方案。该镜像主要提供CodeTrans代码转换服务，支持不同编程语言间的转换，适用于开发人员进行多语言代码迁移、跨语言开发等场景。

核心功能与特性

• 基于openEuler：镜像构建于openEuler系统，免费使用且无每用户速率限制
• 代码转换服务：支持多种编程语言间的转换，核心基于LLM模型
• 可组合架构：提供生成式AI系统的可组合构建块框架，包括LLM、数据存储和提示引擎
• 企业级评估：包含四步评估机制，围绕性能、功能、可信度和企业级就绪度对生成式AI系统进行评级
• 硬件支持：可部署在Intel Gaudi2或Intel Xeon可扩展处理器上

支持的标签及Dockerfile链接

每个CodeTrans Docker镜像的标签由CodeTrans版本和基础镜像版本组成，具体如下：

使用场景与适用范围

• 多语言代码迁移与转换
• 开发人员跨语言开发辅助
• 企业级生成式AI解决方案构建
• 教育领域代码学习与转换教学

使用方法与配置说明

部署方式

目前支持两种通过Docker Compose部署CodeTrans服务的方式：

1. 使用Docker Hub上的镜像：

   bash
   docker pull docker.xuanyuan.run/openeuler/codetrans:latest
   

2. 使用从源码构建的镜像

所需模型

默认情况下，LLM模型设置如下：

快速开始：1. 设置环境变量

1. 设置必要的环境变量：

   bash
   # 示例：host_ip="192.168.1.1"
   export host_ip="外部公网IP"
   # 示例：no_proxy="localhost, 127.0.0.1, 192.168.1.1"
   export no_proxy="你的无代理列表"
   export HUGGINGFACEHUB_API_TOKEN="你的Huggingface API令牌"
   

2. 若处于代理环境，还需设置代理相关环境变量：

   bash
   export http_proxy="你的HTTP代理"
   export https_proxy="你的HTTPS代理"
   

3. 设置其他环境变量：

   获取set_env.sh：https://gitee.com/openeuler/openeuler-docker-images/tree/master/AI/opea/codetrans/doc/set_env.sh

   bash
   source set_env.sh
   

快速开始：2. 运行Docker Compose

获取compose.yml：https://gitee.com/openeuler/openeuler-docker-images/tree/master/AI/opea/codetrans/doc/compose.yml

bash
docker compose -f compose.yml up -d

该命令将自动从Docker Hub下载镜像：

bash
docker pull docker.xuanyuan.run/openeuler/codetrans:latest
docker pull docker.xuanyuan.run/openeuler/codetrans-ui:latest

快速开始：3. 使用代码生成服务

通过终端cURL命令

bash
curl http://${host_ip}:7777/v1/codetrans \
    -H "Content-Type: application/json" \
    -d '{"language_from": "Golang","language_to": "Python","source_code": "package main\n\nimport \"fmt\"\nfunc main() {\n    fmt.Println(\"Hello, World!\");\n}"}'

通过前端界面访问

在浏览器中打开以下URL：http://{host_ip}:5173。默认情况下，UI内部运行在5173端口。

获取帮助

• https://gitee.com/openeuler/cloudnative
• https://gitee.com/openeuler/community

更多信息

• OPEA项目官网：https://opea.dev/
• OPEA技术文档：https://opea-project.github.io/