Skip to main content

Uniform access layer for LLMs of China

Project description

aisuite4cn

PyPI

简单、统一的接口,可连接多个生成式人工智能提供商。

aisuite4cn 针对于中国的各类大模型厂商提供通用的支持。学习了aisuite方案,并开发了该库。

aisuite4cn 使得开发者能够通过标准化的接口轻松使用多个大型语言模型(LLM)。使用类似于OpenAI的接口,aisuite4cn 使得与最受欢迎的LLM互动并比较结果变得简单。它是Python客户端库的轻量级包装器,允许创造者在不改变代码的情况下无缝切换并测试来自不同LLM提供商的响应。我们将在不久的将来扩展它以覆盖更多的用例。

当前支持的提供商包括:

  • Moonshot(月之暗面)
  • Doubao(火山引擎方舟大模型服务平台)
  • Qwen(阿里云千问大模型)
  • Hunyuan(腾讯混元大模型)
  • Ernie(百度文心一言)
  • ZhipuAI(BigModel智谱AI大模型开放平台)
  • DeepSeek(深度求索)
  • Baichuan(百川智能)
  • Spark(讯飞星火)
  • Stepfun(阶跃星辰)
  • Minimax(Minimax)
  • Longcat(美团Longcat大模型)
  • Siliconflow(硅基流动大模型)
  • DMXAPI(中国多模态大模型API聚合平台)
  • Ollama( Get up and running with large language models.
  • Yunwu(云雾)
  • iFlytek(讯飞星火)
  • Custom(自定义)

安装

你可以只安装基础的 aisuite4cn 包,这只会安装基础包,而不会安装任何提供商的SDK。 或者同时安装某个提供商的包和 aisuite4cn包。

请注意,在 create() 调用中的模型名称使用格式为 <provider>:<model-name>aisuite4cn 将根据提供商值调用相应的提供商并传递正确的参数。 提供商的列表可以在目录 aisuite4cn/providers/ 中找到。 支持的提供商的格式为该目录下的 <provider>_provider.py

pip install aisuite4cn

安装通义千问大模型供应商的包

pip install 'aisuite4cn[qwen]'

安装所有大模型供应商的包

pip install 'aisuite4cn[all]'

配置

你需要为你打算使用的提供商获取 API 密钥。你需要单独安装或在安装 aisuite4cn 时安装特定提供商的库。 API 密钥可以设置为环境变量,也可以作为配置传递给 aisuite4cn 客户端构造函数。你可以使用工具如 python-dotenvdirenv 来手动设置环境变量。 以下是一个简短的示例,展示如何使用 aisuite4cn 从 qwen 和 moonshot 生成聊天完成响应。

设置API keys.

export MOONSHOT_API_KEY="your-moonshot-api-key" # 月之暗面开放平台api-key,支持moonshot
export DASHSCOPE_API_KEY="your-dashscope-api-key" # 百炼平台api-key,支持qwen
export ARK_API_KEY = "your-ark-api-key" #火山引擎api-key,支持doubao
export ARK_MODEL_MAP = "modlename1=endpointID&modlename2=endpointID" #火山引擎model map
export HUNYUAN_API_KEY = "your-hunyuan-api-key" #腾讯混元api-key,支持混元
export ZHIPUAI_API_KEY = "your-zhipuai-api-key" #智谱AI api-key,支持ChatGLM
export QIANFAN_ACCESS_KEY = "your-qianfan-access-key" #百度千帆 access key,支持文心一言
export QIANFAN_SECRET_KEY = "your-qianfan-secret-key" #百度千帆 secret key,支持文心一言
export DEEPSEEK_API_KEY="your-deepseek-api-key" # deepseek开放平台api-key,支持deepseek
export BAICHUAN_API_KEY="your-baichuan-api-key" # 百川智能api-key
export MINIMAX_API_KEY="your-minimax-api-key" # MiniMax api-key
export STEP_API_KEY="your-step-api-key" # 阶跃星辰 api-key
export YUNWU_API_KEY="your-yunwu-api-key" # 云雾 api-key
export SPARK_API_KEY_MAP = "modlename1=your-modelname1-api-key&modlename2=your-modelname1-api-key" # 讯飞星火api-key-map
export IFLYTEK_API_KEY="your-iflytek-api-key" # 讯飞星火 x2 api-key
export DMXAPI_API_KEY="your-dmxapi-api-key" # dmxapi api-key,支持dmxapi
export LONGCAT_API_KEY="your-longcat-api-key" # 美团 longcat api-key
export SILICONFLOW_API_KEY="your-siliconflow-api-key" # 硅基流动 api-key,支持硅基流
export CUSTOM_BASE_URL="your-custom-base-url" # 自定义提供商的base-url
export CUSTOM_API_KEY="your-custom-api-key" # 自定义提供商的api-key

使用python客户端

import aisuite4cn as ai
client = ai.Client()

models = [
    "spark:4.0Ultra",
    "spark:generalv3",
    "ark:Doubao-pro-32k",
    "qwen:qwen-max",
    "moonshot:moonshot-v1-8k",
    "hunyuan:hunyuan-standard",
    "qianfan:ernie-3.5-8k",
    "zhipuai:glm-4-flash",
    "deepseek:deepseek-chat",
    "longcat:LongCat-Flash-Chat"
]

messages = [
    {"role": "system", "content": "Respond in Pirate English."},
    {"role": "user", "content": "Tell me a joke."},
]

for model in models:
    response = client.chat.completions.create(
        model=model,
        messages=messages,
        temperature=0.75
    )
    print(response.choices[0].message.content)

License

aisuite4cn 在 MIT 许可证下发布。您可以自由地将代码用于商业和非商业目的。

Integrated Open source project

Special thanks to all contributors

aisuite

https://github.com/andrewyng/aisuite

openai-python

https://github.com/openai/openai-python

Development Guide

Please refer to DEVELOPMENT.md for detailed development and installation instructions.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aisuite4cn-1.1.7.tar.gz (32.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aisuite4cn-1.1.7-py3-none-any.whl (45.5 kB view details)

Uploaded Python 3

File details

Details for the file aisuite4cn-1.1.7.tar.gz.

File metadata

  • Download URL: aisuite4cn-1.1.7.tar.gz
  • Upload date:
  • Size: 32.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.2.1 CPython/3.10.19 Darwin/24.6.0

File hashes

Hashes for aisuite4cn-1.1.7.tar.gz
Algorithm Hash digest
SHA256 7e98288887e97d6575648f771735855100db84f6396b6b81eb2aa49322ee0e9d
MD5 258de5cdb45ecf65a967c86cf6272355
BLAKE2b-256 fd3c2f33f72bf86804a6552deb40bde766950185ea24b39c704950435129a953

See more details on using hashes here.

File details

Details for the file aisuite4cn-1.1.7-py3-none-any.whl.

File metadata

  • Download URL: aisuite4cn-1.1.7-py3-none-any.whl
  • Upload date:
  • Size: 45.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.2.1 CPython/3.10.19 Darwin/24.6.0

File hashes

Hashes for aisuite4cn-1.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 f0b3d16a86829bd85c5fbff91a2b5b253f96f4a6f4026598341083c1a7739764
MD5 ec515822d2c03167640b763831b5c259
BLAKE2b-256 665a7e2ee9db43e9c905a0e8dbfc310296833f6ba1e3b4ef5b0889b8011d156b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page