explaingit

mashaaaaaaaaaaa/safeyay

Analysis updated 2026-05-18

3PythonAudience · developerComplexity · 3/5Setup · moderate

TLDR

A wrapper around the Arch Linux yay package manager that scans AUR packages with ClamAV, a static scanner, and an optional AI reviewer before they are built.

Mindmap

mindmap
  root((repo))
    What it does
      Wraps yay for AUR installs
      Scans PKGBUILDs before build
      Warns on suspicious packages
    Tech stack
      Python
      ClamAV
      Ollama
    Use cases
      Review untrusted AUR packages
      Catch malicious patches
      Add AI review to package installs
    Audience
      Arch Linux users
      Security conscious users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Scan an AUR package's build script for malware signatures before installing it with yay.

USE CASE 2

Add an AI reviewer that checks install scripts and patches for suspicious behavior before a build.

USE CASE 3

Get a confirmation prompt before installing any AUR package that a reviewer flags as suspicious.

What is it built with?

PythonArch LinuxClamAVOllama

How does it compare?

mashaaaaaaaaaaa/safeyay0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity3/52/55/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Arch Linux, yay, and Python 3.11+, AI review needs a configured backend like Ollama.

In plain English

safeyay is a wrapper around yay, a popular helper for installing packages from the Arch User Repository, or AUR. AUR packages are built from community-submitted build scripts that can run arbitrary code on your machine, so before yay builds one, safeyay steps in and runs whichever of three optional review tools you have set up: ClamAV antivirus, a static scanner called ks-aur-scanner, and a configurable AI reviewer. Packages from the official Arch repositories are skipped entirely, since those come as signed, prebuilt packages and never execute an AUR build script. If ClamAV is installed, safeyay scans the package's files for known malware signatures first, and treats a detection as high confidence, refusing to continue immediately without running the other checks. If ks-aur-scanner is installed, it runs as an independent static scanner, and its findings are kept separate from what the AI reviewer sees, so the two make independent judgments. The AI reviewer, when configured, examines the build script itself along with related files such as install scripts, patches, shell scripts, and package manager lockfiles, checks who controls any remote patches being applied, and uses AUR and GitHub metadata to help establish where a package actually comes from. The README is upfront that AI review is an extra signal, not a guarantee, and that models can miss real problems or raise false alarms. You install it either as an Arch package built with makepkg, downloading a checksummed release, or as a per-user install with an included install script. An example configuration works with a local Ollama model. Once set up, you use safeyay exactly where you would normally type yay, and when any reviewer reports something suspicious, it prints the findings and asks whether to continue, defaulting to no. If none of the three review components are configured, safeyay explicitly warns that it is currently providing no security benefit.

Copy-paste prompts

Prompt 1
Walk me through installing safeyay on Arch Linux using makepkg and setting up an Ollama backend for AI review.
Prompt 2
Explain how safeyay's ClamAV, ks-aur-scanner, and AI review layers work together when scanning an AUR package.
Prompt 3
Show me how to use safeyay in place of yay to install a package and understand its suspicious-package prompt.

Frequently asked questions

What is safeyay?

A wrapper around the Arch Linux yay package manager that scans AUR packages with ClamAV, a static scanner, and an optional AI reviewer before they are built.

What language is safeyay written in?

Mainly Python. The stack also includes Python, Arch Linux, ClamAV.

How hard is safeyay to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is safeyay for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.