Ramalama 项目使用教程

Ramalama 项目使用教程

ramalama The goal of RamaLama is to make working with AI boring. 项目地址: https://gitcode.com/gh_mirrors/ra/ramalama

1. 项目目录结构及介绍

Ramalama 项目的目录结构如下：

• bin/：存放编译后的可执行文件。
• completions/：包含命令行自动完成的脚本。
• container-images/：包含用于创建容器镜像的配置和脚本。
• docs/：存放项目的文档。
• hack/：包含一些辅助脚本，用于项目的开发和测试。
• libexec/：包含一些内部使用的工具和脚本。
• logos/：存放项目的标识和图形文件。
• plans/：包含项目构建计划的配置文件。
• ramalama/：项目的主要代码库。
• rpm/：包含用于生成 RPM 包的文件。
• scripts/：存放一些管理脚本。
• shortnames/：包含模型的短名称配置文件。
• test/：包含项目的测试代码。
• 其他文件：包括 .gitignore、CODE-OF-CONDUCT.md、CONTRIBUTING.md、LICENSE、Makefile、README.md、SECURITY.md、container_build.sh、flake.nix、install.sh、pyproject.toml、renovate.json、setup.py 等。

2. 项目的启动文件介绍

项目的启动文件主要是 install.sh 脚本，该脚本用于在 macOS 系统上安装 Ramalama。运行以下命令可以安装 Ramalama：

curl -fsSL https://raw.githubusercontent.com/containers/ramalama/master/install.sh | bash

该脚本会从 GitHub 下载安装脚本并执行，完成 Ramalama 的安装。

3. 项目的配置文件介绍

Ramalama 的配置文件主要是 shortnames.conf 文件，该文件用于定义模型的短名称和对应的完整模型地址。这个文件可以在以下几个路径中找到：

• /usr/share/ramalama/shortnames.conf：管理员配置的短名称。
• /etc/ramalama/shortnames.conf：用户自定义的短名称。
• $HOME/.config/ramalama/shortnames.conf：用户的个人配置文件。

以下是一个 shortnames.conf 文件的示例内容：

[shortnames]
"tiny" = "ollama://tinyllama"
"granite" = "huggingface://instructlab/granite-7b-lab-GGUF/granite-7b-lab-Q4_K_M.gguf"
"granite:7b" = "huggingface://instructlab/granite-7b-lab-GGUF/granite-7b-lab-Q4_K_M.gguf"
"ibm/granite" = "huggingface://instructlab/granite-7b-lab-GGUF/granite-7b-lab-Q4_K_M.gguf"
"merlinite" = "huggingface://instructlab/merlinite-7b-lab-GGUF/merlinite-7b-lab-Q4_K_M.gguf"
"merlinite:7b" = "huggingface://instructlab/merlinite-7b-lab-GGUF/merlinite-7b-lab-Q4_K_M.gguf"

用户可以通过编辑这些文件来添加或修改模型的短名称。

ramalama The goal of RamaLama is to make working with AI boring. 项目地址: https://gitcode.com/gh_mirrors/ra/ramalama