{"id":50370162,"url":"https://github.com/librefang/librefang-registry","last_synced_at":"2026-05-30T06:31:09.992Z","repository":{"id":344307611,"uuid":"1181344531","full_name":"librefang/librefang-registry","owner":"librefang","description":"Community-maintained content registry for LibreFang — agents, hands, integrations, skills, and provider models","archived":false,"fork":false,"pushed_at":"2026-05-10T15:41:26.000Z","size":1668,"stargazers_count":6,"open_issues_count":2,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-10T17:27:27.532Z","etag":null,"topics":["agent","ai-agents","librefang","llm","mcp","registry","toml"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/librefang.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["librefang"]}},"created_at":"2026-03-14T02:49:10.000Z","updated_at":"2026-05-10T15:41:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/librefang/librefang-registry","commit_stats":null,"previous_names":["librefang/model-catalog","librefang/librefang-registry"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/librefang/librefang-registry","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/librefang%2Flibrefang-registry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/librefang%2Flibrefang-registry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/librefang%2Flibrefang-registry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/librefang%2Flibrefang-registry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/librefang","download_url":"https://codeload.github.com/librefang/librefang-registry/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/librefang%2Flibrefang-registry/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33682998,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai-agents","librefang","llm","mcp","registry","toml"],"created_at":"2026-05-30T06:31:09.859Z","updated_at":"2026-05-30T06:31:09.983Z","avatar_url":"https://github.com/librefang.png","language":"Python","funding_links":["https://github.com/sponsors/librefang"],"categories":[],"sub_categories":[],"readme":"# LibreFang Registry\n\nCommunity-maintained content registry for [LibreFang](https://github.com/librefang/librefang) — the open-source Agent Operating System.\n\nThis repository is the **single source of truth** for all installable content definitions. Anyone can submit a PR to add new agents, hands, MCP servers, skills, or provider models — no changes to the LibreFang binary required.\n\n## Overview\n\n| Type | Count | Description |\n|------|------:|-------------|\n| [Hands](#hands) | 14 | User-facing \"apps\" — agent + tools + settings + dashboard |\n| [Agents](#agents) | 32 | Autonomous agent definitions with model config and tools |\n| [MCP Servers](#mcp-servers) | 25 | MCP server connections (GitHub, Slack, DBs, etc.) |\n| [Providers](#providers) | 46 | LLM provider \u0026 model metadata with pricing |\n| [Models](#providers) | 232 | Individual model definitions across all providers |\n| [Aliases](#aliases) | 70 | Short names mapped to canonical model IDs |\n| [Plugins](#plugins) | 10 | Memory, guardrails, and conversation plugins |\n| [Skills](#skills) | 2 | Reusable prompt templates and Python scripts |\n| [Workflows](#workflows) | 9 | Pre-built multi-agent workflow definitions |\n| [Templates](#templates) | 6 | Starter templates for each content type |\n\n## Repository Structure\n\n```\nlibrefang-registry/\n├── agents/                # Agent definitions (TOML manifests)\n│   ├── hello-world/\n│   │   └── agent.toml\n│   ├── researcher/\n│   │   └── agent.toml\n│   └── ...                (32 agents)\n├── hands/                 # Hand definitions (app bundles)\n│   ├── browser/\n│   │   ├── HAND.toml      # Metadata, tools, settings, i18n (6 languages)\n│   │   └── SKILL.md       # Domain expert knowledge injected at runtime\n│   ├── trader/\n│   │   ├── HAND.toml\n│   │   └── SKILL.md\n│   └── ...                (14 hands)\n├── mcp/                   # MCP server templates\n│   ├── github.toml\n│   ├── slack.toml\n│   └── ...                (25 MCP servers)\n├── providers/             # LLM provider \u0026 model metadata\n│   ├── anthropic.toml\n│   ├── openai.toml\n│   └── ...                (46 providers, 232 models)\n├── plugins/               # Memory, guardrails, and utility plugins\n│   ├── episodic-memory/\n│   ├── guardrails/\n│   └── ...                (10 plugins)\n├── skills/                # Reusable skill definitions\n│   ├── custom-skill-prompt/skill.toml\n│   └── custom-skill-python/\n├── workflows/             # Pre-built multi-agent workflow definitions\n│   ├── code-review.toml\n│   ├── research.toml\n│   └── ...                (9 workflows)\n├── templates/             # Starter templates for each content type\n│   ├── agent.toml\n│   ├── HAND.toml\n│   └── ...                (6 templates)\n├── docs/                  # Additional documentation\n│   └── content-guide.md   # Content contribution guidelines\n├── aliases.toml           # Global model alias mappings (70 aliases)\n├── schema.toml            # Provider/model schema reference\n├── scripts/\n│   └── validate.py        # Content validation script\n├── CONTRIBUTING.md\n└── LICENSE                # MIT\n```\n\n## Content Types\n\n### Hands\n\nHands are the **user-facing \"apps\"** in LibreFang. Each hand bundles an agent, tools, user-configurable settings, dashboard metrics, dependency checks, and i18n translations into a single deployable unit.\n\nEvery hand includes a `SKILL.md` — domain-specific expert knowledge that is injected into the agent's context at runtime, giving it deep expertise in its domain.\n\n| Icon | Hand | Category | Description |\n|:----:|------|----------|-------------|\n| 📈 | analytics | data | Data collection, analysis, visualization, dashboards, and automated reporting |\n| 🔌 | apitester | development | Endpoint discovery, request validation, load testing, and regression detection |\n| 🌐 | browser | productivity | Web navigation, form filling, and multi-step web tasks with user approval |\n| 🎬 | clip | content | Turns long-form video into viral short clips with captions and thumbnails |\n| 🔍 | collector | data | Intelligence collection, change detection, and knowledge graphs |\n| 👷 | devops | development | CI/CD management, infrastructure monitoring, deployment, and incident response |\n| 📊 | lead | data | Lead generation, enrichment, scoring, and scheduled delivery |\n| 💼 | linkedin | communication | Profile optimization, content creation, networking, and engagement |\n| 🔮 | predictor | data | Signal collection, calibrated predictions, and accuracy tracking |\n| 📢 | reddit | communication | Subreddit monitoring, content posting, and engagement tracking |\n| 🧪 | researcher | productivity | Deep research, cross-referencing, fact-checking, and structured reports |\n| 🎯 | strategist | productivity | Market research, competitive analysis, and strategic planning |\n| 📈 | trader | data | Multi-signal analysis, adversarial reasoning, and risk management |\n| 𝕏 | twitter | communication | Content creation, scheduled posting, engagement, and analytics |\n\n**HAND.toml format:**\n\n```toml\nid = \"browser\"\nname = \"Browser Hand\"\ndescription = \"Autonomous web browser\"\ncategory = \"productivity\"\nicon = \"🌐\"\ntools = [\"browser_navigate\", \"browser_click\", \"browser_type\"]\n\n[routing]\naliases = [\"browse\", \"open website\"]\nweak_aliases = [\"web\", \"url\"]\n\n[[requires]]\nkey = \"chromium\"\nrequirement_type = \"binary\"\ncheck_value = \"chromium\"\n\n[[settings]]\nkey = \"headless\"\nsetting_type = \"toggle\"\ndefault = \"true\"\n\n[agent]\nname = \"browser-hand\"\nmodule = \"builtin:chat\"\nsystem_prompt = \"\"\"You are an autonomous web browser agent...\"\"\"\n\n[dashboard]\n[[dashboard.metrics]]\nlabel = \"Pages Visited\"\nmemory_key = \"pages_visited\"\nformat = \"number\"\n\n# i18n — 6 languages supported: zh, ja, ko, es, fr, de\n[i18n.zh]\nname = \"浏览器 Hand\"\ndescription = \"自主网页浏览器\"\ncategory = \"生产力\"\n\n[i18n.zh.settings.headless]\nlabel = \"无头模式\"\ndescription = \"在后台运行浏览器\"\n```\n\n### Agents\n\nAgent definitions describe autonomous agents with model configuration, tools, capabilities, and routing aliases.\n\n```toml\nname = \"hello-world\"\ndescription = \"A friendly greeting agent\"\nmodule = \"builtin:chat\"\n\n[model]\nprovider = \"default\"\nmodel = \"default\"\nsystem_prompt = \"You are a helpful assistant.\"\n\n[capabilities]\ntools = [\"web_search\", \"file_read\"]\n```\n\n**32 built-in agents:** academic-researcher, analyst, architect, assistant, code-reviewer, coder, customer-support, data-scientist, debugger, devops-lead, doc-writer, email-assistant, health-tracker, hello-world, home-automation, legal-assistant, meeting-assistant, ops, orchestrator, personal-finance, planner, recipe-assistant, recruiter, researcher, sales-assistant, security-auditor, social-media, test-engineer, translator, travel-planner, tutor, writer\n\n### MCP Servers\n\nMCP server templates define [MCP](https://modelcontextprotocol.io/) server connections with transport configuration, required environment variables, and setup instructions.\n\n```toml\nid = \"github\"\nname = \"GitHub\"\ncategory = \"devtools\"\n\n[transport]\ntype = \"stdio\"\ncommand = \"npx\"\nargs = [\"-y\", \"@modelcontextprotocol/server-github\"]\n\n[[required_env]]\nname = \"GITHUB_PERSONAL_ACCESS_TOKEN\"\nis_secret = true\n```\n\n**25 MCP servers across 6 categories:**\n\n| Category | MCP Servers |\n|----------|-------------|\n| DevTools | bitbucket, github, gitlab, jira, linear, sentry |\n| Data | elasticsearch, mongodb, postgresql, redis, sqlite |\n| Productivity | dropbox, gmail, google-calendar, google-drive, notion, todoist |\n| Communication | discord, slack, teams |\n| Cloud | aws, azure, gcp |\n| AI Search | brave-search, exa-search |\n\n### Providers\n\nProvider files define LLM providers and their models with pricing, context windows, and capability flags. See [schema.toml](schema.toml) for the full field reference.\n\n**49 providers** including: Anthropic, OpenAI, Google Gemini, DeepSeek, Groq, Mistral, Cohere, xAI, Together, Fireworks, Ollama (local), LM Studio (local), vLLM (self-hosted), Alibaba Coding Plan, and many more.\n\n**339 models** with metadata for each: pricing (input/output per token), context window size, capability flags (vision, function calling, streaming), and tier classification.\n\n### Aliases\n\nGlobal model alias mappings in [aliases.toml](aliases.toml) let users reference models by short names:\n\n```toml\n\"sonnet\" = \"claude-sonnet-4-6\"\n\"gpt4\" = \"gpt-4o\"\n\"flash\" = \"gemini-2.5-flash\"\n\"deepseek\" = \"deepseek-chat\"\n```\n\nModels can also define aliases directly in their provider TOML files, which are auto-registered at load time.\n\n### Plugins\n\nPlugins extend agent capabilities with memory systems, safety guardrails, and conversation utilities.\n\n**10 plugins:** auto-summarizer, context-decay, conversation-logger, episodic-memory, guardrails, keyword-memory, sentiment-tracker, todo-tracker, topic-memory, user-profile\n\n### Skills\n\nReusable prompt templates or Python scripts that agents can invoke.\n\n```toml\n[skill]\nname = \"meeting-agenda\"\ndescription = \"Generate a structured meeting agenda\"\n\n[runtime]\ntype = \"promptonly\"\n\n[prompt]\ntemplate = \"Create a meeting agenda for: {{topic}}\"\n```\n\n### Workflows\n\nPre-built multi-agent workflow definitions in `workflows/\u003cname\u003e.toml` orchestrate multiple agents for complex tasks.\n\n**9 workflows:** brainstorm, code-review, content-pipeline, content-review, customer-support, data-pipeline, research, translate-polish, weekly-report\n\n### Templates\n\nStarter templates in `templates/` for creating new content. Copy a template to get started quickly:\n\n```bash\ncp templates/agent.toml agents/my-agent/agent.toml\ncp templates/HAND.toml hands/my-hand/HAND.toml\n```\n\n**6 templates:** agent.toml, HAND.toml, integration.toml, plugin.toml, provider.toml, skill.toml\n\nSee also [docs/content-guide.md](docs/content-guide.md) for naming conventions and contribution guidelines.\n\n## Usage\n\n### Install from Registry\n\n```bash\n# Update all registry content\nlibrefang catalog update\n\n# Install a specific hand\nlibrefang hand install browser\n\n# Install a specific MCP server\nlibrefang mcp install github\n```\n\n### Custom Local Content\n\nCreate custom content locally without submitting to this registry:\n\n```bash\n# Custom agent\nmkdir -p ~/.librefang/agents/my-agent\n# Edit ~/.librefang/agents/my-agent/agent.toml\n\n# Custom model aliases\n# Add to ~/.librefang/model_catalog.toml\n```\n\n## Validation\n\n```bash\npython scripts/validate.py\n```\n\nValidates all content files for correctness: required fields, valid types, non-negative costs, no duplicate IDs.\n\n## Contributing\n\n1. Fork this repository\n2. Add or edit content in the appropriate directory\n3. Run validation: `python scripts/validate.py`\n4. Submit a Pull Request\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions for each content type.\n\n## License\n\nMIT License. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibrefang%2Flibrefang-registry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flibrefang%2Flibrefang-registry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibrefang%2Flibrefang-registry/lists"}