argos-translate

环境要求

• 已安装 Python 与 pip 环境
• 源码安装方式需要 virtualenv
• 下载语言模型包（.argosmodel）时需要联网
• 可选：需要图形界面时装 GUI 包

安装与启动步骤

1. 1安装核心库

   从 PyPI 用 pip 安装 Argos Translate，装好后即可作为 Python 库调用。

   pip install argostranslate

   复制

2. 2安装图形界面

   可选步骤，安装 Argos Translate GUI，方便不写代码直接翻译；不需要可跳过。

   pip install argostranslategui

   复制

3. 3源码安装

   克隆仓库后在 virtualenv 虚拟环境中以可编辑模式安装，适合开发或改源码。

   git clone https://github.com/argosopentech/argos-translate.git
   cd argos-translate
   virtualenv env
   source env/bin/activate
   pip install -e .

   复制

4. 4安装语言包

   更新索引、按语言对筛选并下载安装模型包；from_code/to_code 换成实际语言代码，如 en、es。

   from_code = "en"
   to_code = "es"
   
   import argostranslate.package
   argostranslate.package.update_package_index()
   available_packages = argostranslate.package.get_available_packages()
   package_to_install = next(
       filter(
           lambda x: x.from_code == from_code and x.to_code == to_code, available_packages
       )
   )
   argostranslate.package.install_from_path(package_to_install.download())

   复制

5. 5卸载与清理

   不再使用时卸载库；如想彻底清理，可再删除缓存和数据目录。

   pip uninstall argostranslate
   rm -r ~/.local/cache/argos-translate
   rm -r ~/.local/share/argos-translate

   复制

关键配置

如何确认成功

在 Python 中 import argostranslate 不报错，且 get_available_packages() 能返回可用语言包列表即安装成功。

常见问题

注意事项

• 使用枢轴翻译（经中间语言）时翻译质量会有一定损失。
• 源码安装完成后需先激活虚拟环境再使用，否则可能调用到系统里的其他版本。
• 卸载后可选删除 ~/.local/cache/argos-translate 与 ~/.local/share/argos-translate 释放空间。