# RubyGems Package Intelligence — Gem Health & Downloads (AI) (`noniner/rubygems-package-intelligence`) Actor

Analyze any Ruby gem (RubyGems): downloads, dependencies, maintenance recency, release cadence, authors, license and an AI risk read (unmaintained, no license, heavy deps). For dependency due diligence and supply-chain risk.

- **URL**: https://apify.com/noniner/rubygems-package-intelligence.md
- **Developed by:** [Fredrik Hansson](https://apify.com/noniner) (community)
- **Categories:** Developer tools, AI, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $44.00 / 1,000 package analyzeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## RubyGems Package Intelligence — Gem Health & Downloads (AI)

**Before you add a Ruby dependency, know what you're pulling in.** Give this Actor a list of RubyGems gem names and it turns each one into a clear intelligence record: how often it's downloaded, how many dependencies it drags in, when it was last released, how fast it ships, who maintains it, its license — and an **AI risk read** that tells you plainly whether a gem is active, stale, or effectively abandoned.

You bring the gem names. It hands back a dependency due-diligence sheet.

***

### The flow

```
1. Paste RubyGems gem names        2. The Actor gathers facts            3. Get an AI risk read
   (rails, devise, sidekiq,   →       RubyGems API (gems +          →      downloads · deps · age ·
    ...)                               versions, public, no key)            license · maintenance · flags
```

1. **Paste RubyGems (Ruby) gem names** into the `packages` field — one per line.
2. **The Actor pulls public data** for each: the [RubyGems API](https://rubygems.org/) gem endpoint for metadata, total/version downloads, dependencies and license, and the versions endpoint for version count, latest release date and release cadence. No API key, no scraping of login-walled pages.
3. **The AI layer reads the facts** and returns a maintenance signal, a popularity tier, concrete risk flags and a two-sentence summary — grounded only in the data, never invented.

***

### What you get per gem

For every gem, the Actor returns:

1. **Identity & release** — `latestVersion`, `summary`, `versionCount`, `lastRelease` (ISO timestamp), `lastReleaseAgeDays` (how long since the newest release) and `releaseCadenceDays` (average days between releases across history).
2. **Reach** — `totalDownloads` (all-time) and `latestVersionDownloads` from RubyGems, so you can tell a ubiquitous library from a weekend experiment.
3. **Footprint** — `runtimeDependenciesCount` and `developmentDependenciesCount` (how many gems it requires), and `license`.
4. **Maintenance signals** — `authorsCount`, and the `repository`, `homepage` and `documentation` URLs.

Then the **AI layer** (OpenAI `gpt-4o-mini`, a fast and low-cost model) adds:

- **`maintenanceSignal`** — `active`, `maintained`, `stale`, or `abandoned`, from release recency.
- **`popularityTier`** — `niche`, `growing`, `popular`, or `ubiquitous`, from download volume.
- **`riskFlags`** — short, data-backed phrases: `"unmaintained (last release >18mo)"`, `"single author"`, `"no license declared"`, `"heavy dependency tree"`, `"very few releases"`.
- **`aiSummary`** — two factual sentences on the gem and its risk posture.
- **`suggestedAlternatives`** — only well-known, widely-trusted substitutes for the same job, else `[]`.

***

### Three ways people use it

- **Ruby dependency due diligence** — before a new gem lands in your `Gemfile` or `.gemspec`, run a **RubyGems package analysis** to see downloads, license, dependency count and whether it's still maintained. Catch an abandoned gem, a no-license release or a single-maintainer bus factor *before* it's in your build.
- **Supply-chain risk** — audit an existing dependency list for **Ruby dependency risk**: surface **unmaintained gems**, stale projects and heavy dependency trees across your whole stack in one run. A standing input for your **supply chain** security reviews.
- **Library selection** — comparing candidates for the same job? Line them up and let download tier, maintenance signal and `suggestedAlternatives` make the call obvious.

Keywords: RubyGems package analysis, Ruby dependency risk, supply chain, unmaintained gems.

***

### Input

| Field | Type | Notes |
|---|---|---|
| `packages` | array | **Required.** RubyGems gem names, one per line (e.g. `rails`, `devise`, `sidekiq`). Version pins and `rubygems.org/gems/...` URLs are tolerated and normalised. |
| `maxResults` | integer | Cap how many gems to analyze. Default `200`. |
| `maxConcurrency` | integer | Gems processed in parallel. Default `6`. |
| `model` | string | OpenAI model override. Default `gpt-4o-mini`. |

#### Minimal input example

```json
{
  "packages": ["rails", "devise", "sidekiq"]
}
```

***

### Output example

```json
{
  "package": "rails",
  "latestVersion": "8.1.4",
  "summary": "Ruby on Rails is a full-stack web framework optimized for programmer happiness and sustainable productivity.",
  "license": "MIT",
  "totalDownloads": 799616881,
  "latestVersionDownloads": 1262910,
  "lastRelease": "2026-09-24T14:22:14.180Z",
  "lastReleaseAgeDays": 18,
  "releaseCadenceDays": 14,
  "versionCount": 521,
  "authorsCount": 1,
  "runtimeDependenciesCount": 13,
  "developmentDependenciesCount": 0,
  "repository": "https://github.com/rails/rails/tree/v8.1.4",
  "homepage": "https://rubyonrails.org",
  "documentation": "https://api.rubyonrails.org/v8.1.4/",
  "maintenanceSignal": "active",
  "popularityTier": "ubiquitous",
  "riskFlags": [],
  "suggestedAlternatives": ["sinatra", "hanami"],
  "aiSummary": "rails is a ubiquitous, permissively licensed full-stack web framework with hundreds of millions of all-time downloads and an actively maintained release line. It carries a moderate runtime dependency tree and shows no significant supply-chain risk."
}
```

A gem that is not found on RubyGems comes back with the same shape plus an `error` field (and is not charged).

***

### Pay-per-event pricing

This Actor uses **pay-per-event** billing with a single event:

| Event | Price | Charged when |
|---|---|---|
| `package-analyzed` | $0.10 | Once per gem successfully analyzed (facts gathered + AI risk read produced). |

The Actor logs its OpenAI token usage and the estimated AI cost per gem at the end of every run, so the event price always stays safely above the model cost.

***

### Data source

Everything comes from **public, key-less sources**: the RubyGems API gem endpoint (`https://rubygems.org/api/v1/gems/<gem>.json`) for metadata, downloads, dependencies and license, and the versions endpoint (`https://rubygems.org/api/v1/versions/<gem>.json`) for version count, latest release date and release cadence. Rate limiting or a missing versions record is handled gracefully — the record still ships, just without release history.

***

### Setup

The AI layer calls the OpenAI API. Set the environment variable / secret **`OPENAI_API_KEY`** on the Actor. The fact-gathering step (downloads, dependencies, license, maintenance) needs no key.

***

### Use it from an AI agent (Apify MCP server)

This Actor is available through the [Apify MCP server](https://mcp.apify.com), so AI agents (Claude, ChatGPT, or anything that speaks MCP) can call it as a tool — hand it a list of `packages` and read back the intelligence records — with no custom integration code.

***

### Run it locally

```bash
npm install
## put your input in storage/key_value_stores/default/INPUT.json
export OPENAI_API_KEY=sk-...
apify run -p
```

***

### Related actors

- [npm Package Intelligence](https://apify.com/noniner/npm-package-intelligence) — The Node.js twin of this Actor: downloads, dependencies, maintenance and AI risk for any npm package.
- [PyPI Package Intelligence](https://apify.com/noniner/pypi-package-intelligence) — The Python twin: downloads, dependencies, maintenance and AI risk for any PyPI package.
- [GitHub Repo Analyzer](https://apify.com/noniner/github-repo-analyzer) — Health, activity and maintenance signals for any GitHub repository.
- [CVE Vulnerability Lookup](https://apify.com/noniner/cve-vulnerability-lookup) — Look up known vulnerabilities and severity for packages and software.

***

**Part of the [No Niner](https://noniner.io) toolkit** — no-code web scraping, enrichment & AI data tools, all pay-per-use. Browse the full set at **[noniner.io](https://noniner.io)**.

# Actor input Schema

## `packages` (type: `array`):

RubyGems (Ruby) gem names to analyze. One per line (e.g. rails, devise, sidekiq).

## `maxResults` (type: `integer`):

Max gems to analyze. One pay-per-event charge per gem analyzed.

## `maxConcurrency` (type: `integer`):

How many gems to process in parallel.

## `model` (type: `string`):

Override the model (default gpt-4o-mini).

## Actor input object example

```json
{
  "packages": [
    "rails",
    "devise",
    "sidekiq"
  ],
  "maxResults": 200,
  "maxConcurrency": 6
}
```

# Actor output Schema

## `packages` (type: `string`):

All analyzed gem records in the default dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "packages": [
        "rails",
        "devise",
        "sidekiq"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("noniner/rubygems-package-intelligence").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "packages": [
        "rails",
        "devise",
        "sidekiq",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("noniner/rubygems-package-intelligence").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "packages": [
    "rails",
    "devise",
    "sidekiq"
  ]
}' |
apify call noniner/rubygems-package-intelligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,noniner/rubygems-package-intelligence"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/YPxHyrqF0cmLx8DCU/builds/2N1259NVYZKD7lOwh/openapi.json