{"id":13631108,"url":"https://github.com/shoutsid/townhall","last_synced_at":"2025-04-17T18:31:52.993Z","repository":{"id":200315686,"uuid":"705251324","full_name":"shoutsid/townhall","owner":"shoutsid","description":"A Python-based chatbot project built on the autogen and tinygrad foundation, utilizing advanced agents for dynamic conversations and function orchestration, enhancing and expanding traditional chatbot capabilities.","archived":false,"fork":false,"pushed_at":"2024-10-09T02:46:09.000Z","size":5443,"stargazers_count":27,"open_issues_count":17,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-18T22:05:45.586Z","etag":null,"topics":["agent-based","agent-based-framework","ai","autogen","chat-application","chatbot","gpt","gpt-2","gpt-3","gpt2","gpt3-turbo","gpt4","llama","llm","tinygrad"],"latest_commit_sha":null,"homepage":"https://shoutsid.github.io/townhall/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shoutsid.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}},"created_at":"2023-10-15T13:47:35.000Z","updated_at":"2024-10-04T05:56:16.000Z","dependencies_parsed_at":"2024-01-12T12:12:48.379Z","dependency_job_id":"9df19a1e-1e43-4ae9-93f5-c645bceadf20","html_url":"https://github.com/shoutsid/townhall","commit_stats":{"total_commits":185,"total_committers":3,"mean_commits":"61.666666666666664","dds":"0.15135135135135136","last_synced_commit":"7713d1f3f26ee73a3ceade643e23d25aabc07edd"},"previous_names":["shoutsid/townhall"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shoutsid%2Ftownhall","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shoutsid%2Ftownhall/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shoutsid%2Ftownhall/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shoutsid%2Ftownhall/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shoutsid","download_url":"https://codeload.github.com/shoutsid/townhall/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249366046,"owners_count":21258296,"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-based","agent-based-framework","ai","autogen","chat-application","chatbot","gpt","gpt-2","gpt-3","gpt2","gpt3-turbo","gpt4","llama","llm","tinygrad"],"created_at":"2024-08-01T22:02:10.865Z","updated_at":"2025-04-17T18:31:52.123Z","avatar_url":"https://github.com/shoutsid.png","language":"Jupyter Notebook","funding_links":[],"categories":["Jupyter Notebook"],"sub_categories":[],"readme":"![Townhall Banner](docs/banner.png)\n\n# Townhall\n\n🚧 Under heavy development and in transition from a previous personal project. Not ready for production use. 🚧\n\n[![GitHub contributors](https://img.shields.io/github/contributors/shoutsid/townhall.svg)]()\n[![GitHub issues](https://img.shields.io/github/issues/shoutsid/townhall.svg)]()\n[![GitHub pull requests](https://img.shields.io/github/issues-pr/shoutsid/townhall.svg)]()\n[![GitHub forks](https://img.shields.io/github/forks/shoutsid/townhall.svg?style=social\u0026label=Fork)]()\n[![GitHub stars](https://img.shields.io/github/stars/shoutsid/townhall.svg?style=social\u0026label=Stars)]()\n[![GitHub watchers](https://img.shields.io/github/watchers/shoutsid/townhall.svg?style=social\u0026label=Watch)]()\n[![GitHub followers](https://img.shields.io/github/followers/shoutsid.svg?style=social\u0026label=Follow)]()\n[![GitHub license](https://img.shields.io/github/license/shoutsid/townhall.svg)]()\n[![Security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)\n\nTownhall is a cutting-edge chatbot framework crafted in Python and grounded on the robust Autogen foundation. This isn't just another chatbot; Townhall leverages the power of advanced agents to breathe life into conversations and elevate them to a whole new level.\n\n### 🧱 The Autogen Foundation: The Bedrock of Innovation\nAt its core, Townhall is built upon the Autogen framework, a pioneering platform for LLMs. Autogen enables the creation of agents that are not only customizable but also conversational. These agents can interact with each other, and seamlessly incorporate human inputs, setting the stage for more dynamic and intelligent dialogues.\n\nOur advanced agents go beyond merely responding to user queries; they orchestrate multiple functions to provide a cohesive and engaging user experience. Think of them as the conductors of a grand symphony, where each instrument is a unique function or feature. They coordinate these functions to create a harmonious and effective dialogue, far outclassing traditional chatbots which often feel like disjointed sets of scripted responses. The advanced agents adapt and learn, making each conversation better than the last. They can switch between various modes, employing a blend of LLMs, human inputs, and specialized tools to deliver a personalized conversational experience.\n\n## Table of Contents\n\n1. [Features](#features)\n2. [Prerequisites](#prerequisites)\n3. [Installation](#installation)\n4. [Usage](#usage)\n5. [Contributing](#contributing)\n6. [Testing](#testing)\n7. [Roadmap](#roadmap)\n8. [Credits](#credits)\n9. [License](#license)\n\n## 📝 Prerequisites\n\nBefore you begin, ensure you have met the following requirements:\n\n- Python 3.10 or higher\n- pip package manager\n- sqlite3\n\n## 🛠️ Installation\n\n### Docker Compose\n\n```bash\ngit clone --recurse-submodules https://github.com/shoutsid/townhall.git\ncd townhall\ndocker compose up -d\ndocker compose exec townhall bash\n./setup.sh\n```\n\n### For Linux\n\n```bash\ngit clone --recurse-submodules https://github.com/shoutsid/townhall.git\ncd townhall\n./setup.sh\n```\n\n### For Mac/Windows\nThe easiest way to get setup on windows is to start playing is click below to use the Github Codespace. Otherwise this was developed on WSL Ubuntu.\n\n[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/shoutsid/townhall?quickstart=1)\n\n\n## 🌐 Usage\n\n### Agents\n\nEach agent can be run independently. To start an product_manager agent for example, run the following commands:\n\n```bash\nexport OPENAI_API_KEY=\u003cyour-api-key\u003e\npython3 townhall/agents/product_manager.py\n```\n\n### LLaMa Integration\nTo start the Llama module, run the following commands:\n\n```bash\npip install -r requirements.txt\ncd townhall/models/llama/weights/\nbash pull_llama.sh\ncd ../../../..\npython3 townhall/models/llama/llama.py\n```\n\n### GPT-2 Integration\n\nTo start the GPT-2 module, run the following commands:\n\n```bash\npython3 townhall/models/gpt2/gpt2.py\n```\n\n## 🤝 Contributing\n\nIf you would like to contribute to Townhall, please fork the repository and use a feature branch. Pull requests are warmly welcome.\n\n## 🧪 Testing\n\nTo run the tests:\n\n```bash\npytest\n```\n\n## 🗺️ Roadmap\n\nFor the detailed roadmap of upcoming features, please visit our [Project Board](https://github.com/users/shoutsid/projects/1).\n\n## 👏 Credits\n\n- **Prompt Contributions**: A big thank you to [Josh-XT](https://github.com/Josh-XT) for the various prompts. Check out his repository [AGiXT](https://github.com/Josh-XT/AGiXT) for more details.\n- **Autogen Foundation**: Townhall is built upon the robust [Autogen Framework](https://github.com/microsoft/autogen/), a pioneering platform for LLMs by Microsoft.\n- **OpenAI Assistant**: Special mention to [OpenAI Assistant](https://chat.openai.com/) for aiding in the development process.\n- **tinygrad**: Special thanks to [tinygrad](https://github.com/tinygrad/tinygrad) for providing the foundational machine learning framework that enhances our project's capabilities.\n\n\nDeveloped by @shoutsid.\n\n\n## 📜 License\n\nThis project is licensed under the GNU GENERAL PUBLIC LICENSE . See the [LICENSE.md](LICENSE.md) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshoutsid%2Ftownhall","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshoutsid%2Ftownhall","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshoutsid%2Ftownhall/lists"}