README.md

---
title: Hidden Gems - Undervalued HF Models
sdk: docker
app_port: 7860
---

# 🔍 Hidden Gems Finder

An MCP Server that discovers undervalued Hugging Face models with high likes-to-downloads ratios — quality models that haven't gone viral yet!

## What are Hidden Gems?

The **Hidden Gem Score** = Likes / Downloads

- **High ratio** = Loved by the community, but not widely adopted (undervalued!)
- **Low ratio** = Popular but mainstream (already discovered)

This helps you find quality models before they blow up.

## MCP Tools

### `find_hidden_gems`

Search for undervalued models with various filters:

**Parameters:**
- `limit` (int): Models to fetch from API (default: 100)
- `min_downloads` (int): Filter out brand-new models (default: 100)
- `top` (int): Number of results to return (default: 20)
- `pipeline_tag` (str, optional): Filter by type like "text-generation", "image-to-text"
- `sort_by` (str): Sort by "ratio" (default), "likes", "downloads", or "trending"

**Example:** Find text generation gems
```json
{
  "limit": 200,
  "min_downloads": 100,
  "top": 10,
  "pipeline_tag": "text-generation",
  "sort_by": "ratio"
}
```

### `get_model_details`

Get detailed information about a specific model:

**Parameters:**
- `model_id` (str): The model ID (e.g., "microsoft/DialoGPT-medium")

**Example:**
```json
{"model_id": "openbmb/MiniCPM-SALA"}
```

## Usage Examples

### Find Top 20 Hidden Gems
```
find_hidden_gems()
```

### Find Text Generation Gems
```
find_hidden_gems(pipeline_tag="text-generation", top=15)
```

### Deep Search
```
find_hidden_gems(limit=500, min_downloads=500, top=50, sort_by="likes")
```

### Check Specific Model
```
get_model_details("xai-org/grok-1")
```

## Connecting to Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "hidden-gems": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://evalstate-hidden-gems.hf.space/mcp"]
    }
  }
}
```

## Environment Variables

- `HF_TOKEN`: Optional Hugging Face token for higher API rate limits