{"id":15597953,"url":"https://github.com/nalbion/agent-adapters","last_synced_at":"2025-09-20T08:33:00.104Z","repository":{"id":222223557,"uuid":"756627190","full_name":"nalbion/agent-adapters","owner":"nalbion","description":"Framework for configurable AI Agents","archived":false,"fork":false,"pushed_at":"2024-08-07T09:39:41.000Z","size":532,"stargazers_count":7,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-30T20:10:20.943Z","etag":null,"topics":["agent-protocol","agents","ai","ai-agents","aiconfigfiles","autogen","autogpt","llm","open-ai","openai"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nalbion.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2024-02-13T01:21:49.000Z","updated_at":"2024-09-21T23:34:03.000Z","dependencies_parsed_at":"2024-03-22T16:38:15.570Z","dependency_job_id":null,"html_url":"https://github.com/nalbion/agent-adapters","commit_stats":null,"previous_names":["nalbion/agent-adapters"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalbion%2Fagent-adapters","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalbion%2Fagent-adapters/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalbion%2Fagent-adapters/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalbion%2Fagent-adapters/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nalbion","download_url":"https://codeload.github.com/nalbion/agent-adapters/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233648603,"owners_count":18708225,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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-protocol","agents","ai","ai-agents","aiconfigfiles","autogen","autogpt","llm","open-ai","openai"],"created_at":"2024-10-03T01:24:43.136Z","updated_at":"2025-09-20T08:32:54.772Z","avatar_url":"https://github.com/nalbion.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# agent-adapters\n\nFramework for configurable AI Agents.\n\nInspired by with [AutoGen](https://github.com/microsoft/autogen) and compatible with [AIConfig](https://aiconfig.lastmileai.dev/) and [Agent Protocol](https://agentprotocol.ai/). Can also download invoke and invoke arbitrary Agents as a subprocess.\n\n## Installation\n\nTo install this library, you can use npm:\n\n```\nnpm install agent-adapters\n```\n\n## Usage\n\nImport the library in your TypeScript/JavaScript file:\n\n```typescript\nimport { readAgentConfig, createAgent } from \"agent-adapters\";\n```\n\n## agents.yml\n\nThe `agents.yml` file is inspired by [AutoGen](https://github.com/microsoft/autogen) and is compatible with [AIConfig](https://aiconfig.lastmileai.dev/), with the additional condition that the `description` field must be provided as it is used by GitHub Copilot Chat and LLM-based routing.\n\n`createAgent()` uses some of the optional properties of the `AgentConfig` to determine which type of Agent to create:\n\n- `agent.routing.team` -\u003e `RouterAgent` - see **Routing** below.\n- `agent.remote` -\u003e `AgentProtocolAgent` - refer [agentprotocol.ai](https://agentprotocol.ai/)\n- `agent.cli.command` -\u003e `CliClientAgent` - executes an Agent from a command line (useful for calling Python agents from Node.JS etc)\n- `agent.llm_config.config_list` -\u003e If an LLM has been configured will use OpenAI, local LLMs etc\n- If No LLM has been configured, will attempt to use GitHub Copilot\n\nIf `agent.vscode === true` the Agent will be available by mentioning it by `@{name}` in VS Github Copilot Chat (when [ChatAgents2 proposal](https://code.visualstudio.com/api/advanced-topics/using-proposed-api#using-a-proposed-api) is released).\n\n### Routing\n\nAll Agents automatically register themselves with the `AgentRegistry` upon construction.\nAgents may use `AgentRegistry.searchAgents()` to search by name or `role`, and matching Agents will be ranked based on the `context`.\n\nNote: Name your agents carefully - if an Agent attempts to send a message to another Agent by `role` (eg \"developer\") and an Agent exists with a **name** matching that role, it will receive the message.\n\n- role: \"developer\", \"tester\" etc\n- context: `{ language: [\"javascript\", \"typescript\"], platform: [\"web\"], framework: [\"react\"], ... }`\n\n## Development\n\nTo develop this library, you need to have Node.js and npm installed. After cloning the repository, install the dependencies:\n\n```\nnpm install\n```\n\nYou can then run the tests:\n\n```\nnpm test\n```\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\nPlease make sure to update tests as appropriate.\n\n## License\n\n[Mozilla Public License 2.0](https://choosealicense.com/licenses/mpl-2.0/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnalbion%2Fagent-adapters","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnalbion%2Fagent-adapters","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnalbion%2Fagent-adapters/lists"}