Skip to content

Conversation

@olliewalsh
Copy link
Collaborator

@olliewalsh olliewalsh commented Dec 4, 2025

Summary by Sourcery

Bump RamaLama to version 0.15.0 and update configuration and macOS documentation accordingly.

Documentation:

  • Document new configuration options for logging level, RAG container images, and user preference to suppress macOS GPU prompts.
  • Align all CLI and man page examples with RamaLama version 0.15.0 and updated default image tag behavior.
  • Add a macOS installation guide covering installer usage, pip/source installs, prerequisites, uninstallation, and troubleshooting.

Chores:

  • Update the Python package version constant and RPM spec to 0.15.0 to match the new release.

Signed-off-by: Oliver Walsh <[email protected]>
@sourcery-ai
Copy link
Contributor

sourcery-ai bot commented Dec 4, 2025

Reviewer's Guide

Bumps RamaLama to version 0.15.0 across code, packaging, and docs, while expanding configuration documentation (env, logging, RAG images, and user preferences) and adding a new macOS installation guide manpage-derived doc.

File-Level Changes

Change Details Files
Update configuration reference to document new fields and correct ordering in ramalama.conf.
  • Move the env configuration key to follow engine and clarify its usage for container runtime environment variables
  • Rename the commented gguf quantization option to the active gguf_quantization_mode field
  • Add log_level configuration option description with valid values and interaction with --debug
  • Introduce rag_images configuration and accelerator-specific image mappings for RAG content
  • Document a new ramalama.user table with a no_missing_gpu_prompt boolean to suppress macOS GPU prompt
docsite/docs/configuration/conf.mdx
Bump RamaLama version from 0.14.0 to 0.15.0 in code, packaging, and CLI/manpage examples including image tag semantics.
  • Update the Python version() helper to return 0.15.0
  • Change the specfile macro version0 to 0.15.0 for RPM packaging
  • Adjust all manpages and docsite command references so CLI examples print 0.15.0 instead of 0.14.0
  • Update narrative docs describing default OCI image tags to use :0.15 rather than :0.14 across bench, perplexity, rag, run, and serve commands
ramalama/version.py
rpm/ramalama.spec
docs/ramalama-version.1.md
docsite/docs/commands/ramalama/version.mdx
docs/ramalama-bench.1.md
docs/ramalama-perplexity.1.md
docs/ramalama-rag.1.md
docs/ramalama-run.1.md
docs/ramalama-serve.1.md
docsite/docs/commands/ramalama/bench.mdx
docsite/docs/commands/ramalama/perplexity.mdx
docsite/docs/commands/ramalama/rag.mdx
docsite/docs/commands/ramalama/run.mdx
docsite/docs/commands/ramalama/serve.mdx
Add a macOS installation guide page generated from manpages to the docsite.
  • Introduce a new MACOS_INSTALL.mdx page under misc with frontmatter indicating it is auto-generated from MACOS_INSTALL.md
  • Document multiple macOS installation methods: self-contained installer pkg, pip install, and build from source
  • Explain Podman and Docker prerequisites, including Podman machine setup with libkrun and troubleshooting steps
  • Describe how to build the macOS installer package with PyInstaller and project scripts
  • Provide uninstallation instructions, troubleshooting tips, and links to additional RamaLama resources and system requirements
docsite/docs/misc/MACOS_INSTALL.mdx

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @olliewalsh, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request focuses on a routine version update to 0.15.0, ensuring all internal and external references are consistent. Alongside this, it enhances the project's configurability by introducing new settings and significantly improves user experience for macOS users with a detailed installation and usage guide.

Highlights

  • Version Bump: The project version has been updated from 0.14.0 to 0.15.0 across all relevant files, including documentation, Python source, and RPM spec.
  • Documentation Updates: Several documentation files have been updated to reflect the new version number and introduce new configuration options, including log_level, rag_images, and no_missing_gpu_prompt.
  • New macOS Installation Guide: A comprehensive guide for installing RamaLama on macOS has been added, detailing self-contained installer, pip, and source build methods, along with prerequisites, uninstallation, and troubleshooting.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey there - I've reviewed your changes - here's some feedback:

  • In conf.mdx, the **rag_format**="qdrant" key now has a description that talks about the RAG OCI image and rag_images, which looks like a copy/paste error; either the heading or the description should be adjusted so rag_format and rag_images are documented separately and clearly.
  • The new log_level option description in conf.mdx has a minor typo/formatting issue in the valid values list (error critical), which should likely read error, critical for consistency with the others.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- In `conf.mdx`, the `**rag_format**="qdrant"` key now has a description that talks about the RAG OCI image and `rag_images`, which looks like a copy/paste error; either the heading or the description should be adjusted so `rag_format` and `rag_images` are documented separately and clearly.
- The new `log_level` option description in `conf.mdx` has a minor typo/formatting issue in the valid values list (`error critical`), which should likely read `error, critical` for consistency with the others.

## Individual Comments

### Comment 1
<location> `docsite/docs/configuration/conf.mdx:136-137` </location>
<code_context>
 Pass `--group-add keep-groups` to podman, when using podman.
 In some cases this is needed to access the gpu from a rootless container

+**log_level**=warning
+Set the logging level of RamaLama application.
+Valid Values:
+    debug, info, warning, error critical
+:::note
+ --debug option overrides this field and forces the system to debug
</code_context>

<issue_to_address>
**issue (typo):** Fix logging level list formatting to include a comma between `error` and `critical`.

The list of valid values is missing a comma between `error` and `critical`. Please update it to `debug, info, warning, error, critical` for clarity and consistency with standard logging level names.

```suggestion
Valid Values:
    debug, info, warning, error, critical
```
</issue_to_address>

### Comment 2
<location> `docsite/docs/configuration/conf.mdx:175-177` </location>
<code_context>

 **rag_format**="qdrant"

-Specify the default output format for output of the `ramalama rag` command
-Options: json, markdown, qdrant
+OCI container image to run with the specified AI model when using RAG content.
+
+**rag_images**="quay.io/ramalama/ramalama-rag"
</code_context>

<issue_to_address>
**issue:** The `rag_format` field description appears to describe images, not a format.

The header still shows `**rag_format**="qdrant"`, but the text now describes an OCI image, which fits `rag_images` instead. This suggests the original format-options description was overwritten. Please either restore the format options here, or rename this field if its meaning has actually changed.
</issue_to_address>

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request bumps the version of RamaLama to 0.15.0 and updates the documentation and configuration files accordingly. The changes are mostly correct, but I've found a few minor issues in the documentation related to formatting and content placement that could impact clarity and rendering. My review includes suggestions to fix these issues.

Signed-off-by: Oliver Walsh <[email protected]>
@mikebonnet
Copy link
Collaborator

LGTM

@mikebonnet mikebonnet merged commit e8cb089 into containers:main Dec 5, 2025
16 of 30 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants