{"id":50479583,"url":"https://github.com/joeylu/runtime-free-llm-integration-skills","last_synced_at":"2026-06-01T16:31:20.435Z","repository":{"id":354020359,"uuid":"1221811360","full_name":"joeylu/runtime-free-llm-integration-skills","owner":"joeylu","description":"Runtime-free skills for coding agents to build fail-fast LLM provider integration, starting with Aliyun Bailian / DashScope.","archived":false,"fork":false,"pushed_at":"2026-04-26T18:13:47.000Z","size":37,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-26T20:15:53.562Z","etag":null,"topics":["agent-skills","ai-agents","aliyun-bailian","api-key","byok","coding-agents","dashscope","fail-fast","llm","llm-integration","llm-provider","model-catalog","model-selection","runtime-free"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joeylu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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}},"created_at":"2026-04-26T17:58:55.000Z","updated_at":"2026-04-26T18:27:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/joeylu/runtime-free-llm-integration-skills","commit_stats":null,"previous_names":["joeylu/runtime-free-llm-integration-skills"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/joeylu/runtime-free-llm-integration-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeylu%2Fruntime-free-llm-integration-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeylu%2Fruntime-free-llm-integration-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeylu%2Fruntime-free-llm-integration-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeylu%2Fruntime-free-llm-integration-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joeylu","download_url":"https://codeload.github.com/joeylu/runtime-free-llm-integration-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeylu%2Fruntime-free-llm-integration-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33784625,"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-06-01T02:00:06.963Z","response_time":115,"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-skills","ai-agents","aliyun-bailian","api-key","byok","coding-agents","dashscope","fail-fast","llm","llm-integration","llm-provider","model-catalog","model-selection","runtime-free"],"created_at":"2026-06-01T16:31:15.815Z","updated_at":"2026-06-01T16:31:20.428Z","avatar_url":"https://github.com/joeylu.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# runtime-free-llm-integration-skills\n\nRuntime-free skills for coding agents to build fail-fast LLM provider integration, starting with OpenAI, Aliyun Bailian / DashScope China Mainland, Aliyun Bailian / DashScope International, DeepSeek, Gemini, MiniMax China Mainland, and MiniMax International.\n\n## What problem does this solve?\n\nMany projects want to let users connect their own LLM provider by entering an API key, choosing a model, and enabling features like chat, vision, or image generation.\n\nThe hard part is not just calling an API.\n\nThe hard part is making sure the coding agent does not:\n\n- guess model IDs\n- mix provider names\n- enable unsupported features\n- silently fall back to another model or key\n- hide connection errors\n- build confusing provider/model UI\n\nThis repository provides a lightweight skill-based map for building that integration correctly.\n\n## Core idea\n\nThis is not an LLM gateway, proxy, SDK, or runtime.\n\nIt does not force your application traffic through a bridge like LiteLLM or Portkey.\n\nInstead, it gives coding agents a set of provider integration rules so they can build native LLM connection logic directly inside your project.\n\nThe authoring logic is simple:\n\n\u003e Unknown means unknown.  \n\u003e Unsupported means disabled.  \n\u003e Failed means failed.  \n\u003e Do not guess, do not hide, do not fallback silently.\n\n## Current provider coverage\n\nThe current version includes these concrete provider skills:\n\n- OpenAI API\n- Aliyun Bailian / DashScope China Mainland\n- Aliyun Bailian / DashScope International / Singapore\n- DeepSeek API\n- Gemini Developer API\n- MiniMax China Mainland API\n- MiniMax International API\n\nMiniMax provider skills separate `build` and `plan` profiles: `plan` is chat-only, while `build` includes verified HTTP chat, image generation, and music generation rows. MiniMax HTTP video links are documented as reference-only until the shared contracts add a video request kind.\n\nThe shared structure is designed so more LLM providers can be added later.\n\n## What is included?\n\n- shared request / response / error contracts\n- provider model catalog pattern\n- structured provider pricing matrix pattern\n- live LLM model sync policy for pricing, capabilities, context windows, and token limits\n- connection profile pattern for separate API keys and base URLs\n- request URL matrix pattern for exact provider request endpoints\n- capability matrix rules\n- model selection UI guidance\n- provider configuration UI guidance\n- fail-fast validation rules\n- transport rules for different model modes\n- OpenAI API provider skill\n- Aliyun Bailian / DashScope China Mainland provider skill\n- Aliyun Bailian / DashScope International provider skill\n- DeepSeek API provider skill\n- Gemini Developer API provider skill\n- MiniMax China Mainland provider skill\n- MiniMax International provider skill\n\n## Who is this for?\n\nThis repository is for developers who use coding agents such as Codex, Claude Code, Cursor, or similar tools to build LLM provider integration into their own apps.\n\nTypical use case:\n\n\u003e \"Build a website settings page where users can enter their own LLM API key, select a provider model, test the connection, and enable only verified capabilities.\"\n\n## What this is not\n\nThis is not:\n\n- a runtime service\n- an API proxy\n- a hosted gateway\n- a full model registry\n- a universal LLM SDK\n- a fallback router\n\nIf you want a runtime bridge, use a gateway or SDK.\n\nIf you want a lightweight integration map for coding agents, this repository is for that.\n\n## Basic usage\n\nCopy or reference the relevant skill folder in your coding-agent workflow.\n\nStart from:\n\n```text\nLLM/_shared/\nLLM/skill-llm-openai/\nLLM/skill-llm-aliyun-bailian-cn/\nLLM/skill-llm-aliyun-bailian-intl/\nLLM/skill-llm-deepseek/\nLLM/skill-llm-gemini/\nLLM/skill-llm-minimax-cn/\nLLM/skill-llm-minimax-intl/\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoeylu%2Fruntime-free-llm-integration-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoeylu%2Fruntime-free-llm-integration-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoeylu%2Fruntime-free-llm-integration-skills/lists"}