{"id":17381845,"url":"https://github.com/CharlesCreativeContent/toolhouse-examples","last_synced_at":"2025-02-27T10:30:44.160Z","repository":{"id":256553017,"uuid":"855722726","full_name":"CharlesCreativeContent/toolhouse-examples","owner":"CharlesCreativeContent","description":"AI prompts using the toolhouse sdk","archived":false,"fork":false,"pushed_at":"2024-09-15T02:40:46.000Z","size":149,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-09-15T20:36:15.254Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/CharlesCreativeContent.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":"2024-09-11T11:06:36.000Z","updated_at":"2024-09-15T02:40:49.000Z","dependencies_parsed_at":"2024-09-11T17:13:58.711Z","dependency_job_id":null,"html_url":"https://github.com/CharlesCreativeContent/toolhouse-examples","commit_stats":null,"previous_names":["charlescreativecontent/toolhouse-examples"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CharlesCreativeContent%2Ftoolhouse-examples","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CharlesCreativeContent%2Ftoolhouse-examples/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CharlesCreativeContent%2Ftoolhouse-examples/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CharlesCreativeContent%2Ftoolhouse-examples/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CharlesCreativeContent","download_url":"https://codeload.github.com/CharlesCreativeContent/toolhouse-examples/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219842826,"owners_count":16556565,"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":[],"created_at":"2024-10-16T07:02:01.814Z","updated_at":"2024-10-16T07:04:54.396Z","avatar_url":"https://github.com/CharlesCreativeContent.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\r\n# \u003cimg src=\"https://framerusercontent.com/images/xDisAjh26hdfRjOto5SnUUWvsEQ.svg?scale-down-to=64\" width=\"50\" style=\"position: relative; top: 10px\"\u003e  Building an AI Clinic Agent using Toolhouse\r\n\r\n\u003ca href=\"https://shawncharles.com/toolhouse\"\u003e\u003cimg src=\"https://github.com/CharlesCreativeContent/myImages/blob/main/images/PetGuru.png?raw=true\"\u003e\u003c/a\u003e\r\n\r\nToolhouse is a platform that enables developers to integrate tools into their projects to build powerful AI agents effortlessly. With Toolhouse, you can leverage pre-built tools and create applications that perform a multitude of useful tasks with minimal code.\r\n\r\nYou can start this journey with only three lines of code!\r\n\r\nThis repository explores examples of how you can use our pre-built tools to create applications for various use cases, such as customer service, blog writing, pet care, and more. It also demonstrates how to build an API that integrates the Toolhouse SDK with OpenAI's GPT models.\r\n\r\nFeel free to check out our [demo video](https://youtu.be/LwKPnH0198E) to see Toolhouse in action.\r\n\r\n\u003ca href=\"https://youtu.be/LwKPnH0198E\"\u003e\u003cimg src=\"https://github.com/CharlesCreativeContent/myImages/blob/main/images/ToolhouseThumbnail.png?raw=true\"\u003e\u003c/a\u003e\r\n\r\n## Getting Started\r\n### Step 1: Clone the Repository\r\n```bash\r\ngit clone https://github.com/CharlesCreativeContent/toolhouse-example.git\r\ncd toolhouse-example\r\n```\r\n\r\n### Step 2: Set Up Environment Variables\r\n- Create a .env file in the root directory of the project and add your Toolhouse and OpenAI API keys:\r\n```bash\r\nTOOLHOUSE_API_KEY=your_toolhouse_api_key\r\nOPENAI_API_KEY=your_openai_api_key\r\n```\r\n\r\n### Step 3: Install Dependencies\r\n- Install the required dependencies by running:\r\n```bash\r\npip install -r requirements.txt\r\n```\r\n\r\n### Step 4: Run the Application\r\n- Once all dependencies are installed, you can start the server with:\r\n```bash\r\npython app.py\r\n```\r\nThe server will be running, and you can view the demo application at http://127.0.0.1:8000 and the API documentation at http://127.0.0.1:8000/docs\r\n\r\n### Step 5: Test the API\r\nThe FastAPI application includes a Swagger UI that allows you to test the various endpoints. The available endpoints are:\r\n\r\n## Endpoint Description\r\n| Endpoint  | Description                                                                                   |\r\n|-----------|-----------------------------------------------------------------------------------------------|\r\n| /pets     | Answers pet owners using an veterinary clinics documents and can tell if the clinic is open   |\r\n| /blog     | Generates a first draft of a research blog post including embedded links.                     |\r\n| /customer | Provides customer service answers, adapting to open and closing hours.                        |\r\n| /twitter  | Returns details about Twitter users and sends emails using hunter.io API.                     |\r\n| /test     | A test route to check the integration of the Toolhouse SDK.                                   |\r\n\r\n### Project Structure\r\n- **app.py**: The main file that sets up the FastAPI application and integrates Toolhouse with OpenAI's GPT models.\r\n- **system_prompts.py**: Contains pre-configured system prompts that shape the behavior of each endpoint.\r\n- **demo.html**: Web page demonstrating the retrieval augmented generation (RAG) and search tools for a veterinary clinic.\r\n\r\n## Understanding Toolhouse SDK\r\nToolhouse acts as an orchestration layer between GPT models and various tools. By integrating the Toolhouse SDK, you enable AI models to perform actions based on decisions made during interactions. For instance, the AI can send emails or retrieve customer support information by adding a tool in Toolhouse without the need to update your code.\r\n\r\n### Why Use Toolhouse?\r\nBuilding tools for AI agents can be time-consuming and complex. You need to:\r\n\r\n- Define inputs and outputs.\r\n- Implement robust error handling.\r\n- Manage infrastructure to host the tools.\r\n- Ensure effective communication with the model.\r\n- Deal with different function-calling implementations across models.\r\n\r\nToolhouse simplifies this process by providing a platform where you can use tools written and maintained by developers like you. These tools work with any LLM that supports tool use. As most developers use more than one LLM provider in their deployments, Toolhouse helps you manage your functions across each model seamlessly.\r\n\r\n### Key Benefits\r\n- **Ease of Integration:** Start using powerful tools with minimal code changes.\r\n- **Community-Driven:** Leverage tools developed by a community of developers.\r\n- **Cross-Compatibility:** Works with multiple LLM providers and models.\r\n- **Scalability:** Easily add or update tools without modifying your existing codebase.\r\n\r\n## Join Our Community\r\nOur growing community awaits you! We're looking forward to meeting you. While we focus on subjects relevant to Toolhouse, AI, or code, we're happy to chat about anything.\r\n\r\n[Join us on Discord](https://discord.gg/xPvyBxhHtu)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCharlesCreativeContent%2Ftoolhouse-examples","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCharlesCreativeContent%2Ftoolhouse-examples","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCharlesCreativeContent%2Ftoolhouse-examples/lists"}