{"id":13560567,"url":"https://github.com/LittleLittleCloud/Agent-ChatRoom","last_synced_at":"2025-04-03T16:30:51.014Z","repository":{"id":241382395,"uuid":"802394077","full_name":"LittleLittleCloud/Agent-ChatRoom","owner":"LittleLittleCloud","description":"A multi-agent chatroom for AutoGen agents","archived":false,"fork":false,"pushed_at":"2024-10-18T20:06:44.000Z","size":2182,"stargazers_count":45,"open_issues_count":8,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-29T15:08:11.561Z","etag":null,"topics":["agent","agent-platform","agent-ui","agentic-framework","agentic-workflow","autogen","llm","llm-agent","llm-agents","multi-agent-webui","next","react","semantic-kernel","typescript","webui"],"latest_commit_sha":null,"homepage":"https://littlelittlecloud.github.io/Agent-ChatRoom/","language":"C#","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/LittleLittleCloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-18T07:10:56.000Z","updated_at":"2025-03-28T18:42:00.000Z","dependencies_parsed_at":"2024-08-01T13:16:11.721Z","dependency_job_id":"b1f87ce9-f703-48a7-8cfc-1a3a88719ad8","html_url":"https://github.com/LittleLittleCloud/Agent-ChatRoom","commit_stats":null,"previous_names":["littlelittlecloud/agent-chatroom"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LittleLittleCloud%2FAgent-ChatRoom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LittleLittleCloud%2FAgent-ChatRoom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LittleLittleCloud%2FAgent-ChatRoom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LittleLittleCloud%2FAgent-ChatRoom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LittleLittleCloud","download_url":"https://codeload.github.com/LittleLittleCloud/Agent-ChatRoom/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247036899,"owners_count":20873043,"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","agent-platform","agent-ui","agentic-framework","agentic-workflow","autogen","llm","llm-agent","llm-agents","multi-agent-webui","next","react","semantic-kernel","typescript","webui"],"created_at":"2024-08-01T13:00:46.641Z","updated_at":"2025-04-03T16:30:50.325Z","avatar_url":"https://github.com/LittleLittleCloud.png","language":"C#","funding_links":[],"categories":["Autogen"],"sub_categories":[],"readme":"## Agent Chatroom\n#### An extensible multi-agent platform built on top of AutoGen.Net, shadcn and Orleans.\n\n[![NuGet version](https://badge.fury.io/nu/ChatRoom.SDK.svg)](https://badge.fury.io/nu/ChatRoom.Client) | [website](https://littlelittlecloud.github.io/Agent-ChatRoom/) | Join our [Discord](https://discord.gg/UYwcVfGaeq)\n\n![Agent Chatroom](assets/agent-chatroom-switch-theme.gif)\n\n## 🌟 Highlights\n- **Multi-Agent WebUI**: Chat with multiple agents simultaneously in a web browser.\n- **Code-First**: Use code-first approach to add agents to the chatroom, see [code-first examples](https://github.com/LittleLittleCloud/Agent-ChatRoom/tree/main/example) for more information.\n- **Server mode**: You can run `ChatRoom.Client` as a restful server. For more information, see [Server mode](#-server-mode).\n\n## Quick Start with code-first approach\nYou can create an agent by writing code and add it to chatroom. See [code-first examples](https://github.com/LittleLittleCloud/Agent-ChatRoom/tree/main/example) for how to do it.\n\n## Quick Start with template\nOther than the code-first approach, `Agent Chatroom` also provides a series of templates to help you get started quickly. Use the `list-templates` command to list all available templates and the `create` command to create a configuration from the selected template.\n\n### Step 1 - Install ChatRoom.Client from NuGet\n`Agent Chatroom` is published as a dotnet tool on nuget.org. You can install the latest `Agent Chatroom` client from nuget.org by running the following command, this will install the `ChatRoom.Client` globally:\n\n```bash\ndotnet tool install --global ChatRoom.Client\n```\n\n\u003e [!TIP]\n\u003e `create` command also generates a json schema file for this configuration to provide intellisense in your editor. Use it wisely can greatly save your effort on writing configuration.\n\n### Step 2 - Choose from one of the available templates to get started.\n```bash\nchatroom list-templates # list all available templates\n```\n\nThe command will list all available templates.\n\n![list-templates](assets/list-templates.png)\n### Step 3 - Create configuration from the selected template.\n\n```bash\n# Create \nchatroom create -t chatroom_openai -o chatroom_openai.json\n```\n\n![fill key](assets/fill-openai-key.png)\n\n### Step 4 - Start the chatroom client with the OpenAI agent.\n\nAfter filling in the OpenAI key in the configuration file, you can start the chatroom client with the following command.\n\n```bash\n# start chatroom server\nchatroom run -c chatroom_openai.json\n```\n\nYou will see the following output from chatroom client which indicates the web UI is available at `http://localhost:51237` and `https://localhost:51238`. You can navigate to the web UI in your browser and start chatting with the agents.\n\n```bash\nweb ui is available at: http://localhost:51237;https://localhost:51238\n```\n\n## 📦 Pre-configured Chatrooms\nWe provide the following configuration to help you get started quickly. More configurations will be added in the future.\n- [OpenAI-Chatroom](https://github.com/LittleLittleCloud/OpenAI-Chatroom): chat with OpenAI gpt.\n- [Powershell-Chatroom](https://github.com/LittleLittleCloud/Powershell-ChatRoom): chat with `ps-gpt` and `ps-runner` to help you write and run PowerShell scripts.\n\n## 🌐 Server mode\nTo start a restful backend from `ChatRoom.Client`, add a `server_config` section to the client configuration file.\n\n```json\n// file: chatroom-client-server.json\n\"server_config\": {\n    \"environment\": \"Development\", // one of Development, Staging, Production.\n    \"urls\": \"http://localhost:51234;https://localhost:51235\"\n}\n```\n\nThen, run the following command to start the server. And the server will start on the `http://localhost:51234` and `https://localhost:51235`.\n\n```bash\nchatroom -c chatroom-client-server.json\n```\n\n### Swagger UI for the server\nWhen the environment is set to `Development`, the server will automatically start the Swagger UI at `/swagger` and `/swagger/index.html`. You can also access the complete swagger schema at `/swagger/v1/swagger.json`, or visit [swagger-schema.json](schema/chatroom_client_swagger_schema.json) in this repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLittleLittleCloud%2FAgent-ChatRoom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLittleLittleCloud%2FAgent-ChatRoom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLittleLittleCloud%2FAgent-ChatRoom/lists"}