{"id":13450473,"url":"https://github.com/krohling/bondai","last_synced_at":"2025-04-13T08:18:25.156Z","repository":{"id":190856750,"uuid":"666903272","full_name":"krohling/bondai","owner":"krohling","description":null,"archived":false,"fork":false,"pushed_at":"2024-01-14T02:06:07.000Z","size":43817,"stargazers_count":204,"open_issues_count":5,"forks_count":28,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-04-13T08:18:14.519Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/krohling.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2023-07-16T01:24:01.000Z","updated_at":"2025-03-29T16:07:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"cccef8d7-f9f5-448d-98c8-57e1257fa39b","html_url":"https://github.com/krohling/bondai","commit_stats":null,"previous_names":["krohling/bondai"],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krohling%2Fbondai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krohling%2Fbondai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krohling%2Fbondai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krohling%2Fbondai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/krohling","download_url":"https://codeload.github.com/krohling/bondai/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248681519,"owners_count":21144703,"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-07-31T07:00:34.942Z","updated_at":"2025-04-13T08:18:25.103Z","avatar_url":"https://github.com/krohling.png","language":"Python","funding_links":[],"categories":["[BondAI](https://bondai.dev/)","Python","其他LLM框架","Other LLM Frameworks","Autonomous Agents"],"sub_categories":["Links","文章","Videos Playlists"],"readme":"\u003ca href=\"https://bondai.dev\"\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/bondai-logo.png\" alt=\"Description or Alt text\" style=\"border-radius: 10px; width: 50%;\"  alt=\"logo\"\u003e\n\u003c/p\u003e\n\u003c/a\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://pypi.org/project/bondai/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/bondai\" alt=\"PyPI\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://hub.docker.com/r/krohling/bondai\"\u003e\u003cimg src=\"https://img.shields.io/docker/v/krohling/bondai?logo=docker\" alt=\"Docker\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://colab.research.google.com/drive/1Rmzosq6LD_ZR3MkqQO1M1Af27VAaYNRE?usp=sharing\" style={{marginLeft: '10px'}}\u003e\n        \u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" style={{marginLeft: '10px'}} alt=\"PyPI\"/\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eBuild highly capable Single and Multi-Agent Systems.\u003c/em\u003e\u003c/p\u003e\n\n# \u003ca href=\"https://bondai.dev\"\u003eBondAI Homepage\u003c/a\u003e\n\nCheckout the BondAI Homepage ([https://bondai.dev](https://bondai.dev)) for in depth documentation, examples and API specification.\n\n# Getting Started\n\nThere are 3 ways to use BondAI:\n\n1) 🛠️ **Command Line Interface (CLI)** - This is the easiest way to get up and running fast. Run BondAI on your command line with a pre-configured set of tools.\n\n2) 🐋 **Docker** - Running BondAI in a Docker container is recommended if you plan on using tools that run code or directly access your shell.\n\n3) 🏗️ **Start Coding with BondAI** - Integrate BondAI into your own codebase and start building your own agents.\n\n## 🚀 Installation\n\nInstalling BondAI is easy:\n\n```bash\npip install bondai\n```\n\n## 🛠️ Command Line Interface (CLI)\n\nOnce you've installed BondAI using `pip install bondai` the CLI will be available as an executable accessible simply by running `bondai` in your shell. [Learn more about all of the tools and options available through the CLI](https://bondai.dev/docs/cli).\n\nBefore running `bondai` you will need to set the OPENAI_API_KEY environment variable.\n```bash\nexport OPENAI_API_KEY=sk-XXXXXXXXXX\n```\n\nOnce the environment variable has been set you can run `bondai` to start the CLI.\n\n```bash\nLoading BondAI...\n******************ENTERING CHAT******************\nYou are entering a chat with BondAI...\nYou can exit any time by typing 'exit'.\n\nHello! I'm BondAI, your friendly and helpful assistant. I'm here to assist you with any tasks or questions you might have. How can I assist you today?\n\nI want you to write a story about unicorns and save it to a file named unicorns.md.\nUsing tool file_write: Writing a story about unicorns and saving it to a file named unicorns.md\nUsing tool final_answer...\n\nA story about unicorns has been successfully written and saved to a file named unicorns.md. The story is set in an enchanted forest and describes the magical and majestic nature of unicorns, their daily routines, and their harmonious relationship with other creatures in the forest.\n```\n\n\n## 🐋 Docker\n\nBondAI Docker images are available on [DockerHub here](https://hub.docker.com/r/krohling/bondai). If you intend to use tools that run arbitrary code (*PythonREPLTool*) or access your shell (*ShellTool*) it is highly recommended that you run BondAI in a Docker container as these tools can damage your machine.\n\nBefore running the BondAI Docker container it is recommended that you create a directory named 'agent-volume' and mount it as a volume on the container. This will be used as the Agent's working directory and allows you to easily share files with the Agent.\n\n```bash\nmkdir agent-volume\ndocker pull krohling/bondai:latest\ndocker run -it --rm \\\n           -v ./agent-volume:/agent-volume \\\n           -w /agent-volume \\\n           OPENAI_API_KEY=sk-XXXXXXXXXX \\\n           bondai:latest bondai\n```\n\n## 🔥 Start Coding with BondAI\n\nBondAI has a straightforward API for creating powerful AI Agents. Check out our [examples](https://bondai.dev/docs/category/examples) for ideas on how to get started.  Remember to set your *OPENAI_API_KEY* environment variable before running your BondAI Agent.\n\n```python\nfrom bondai.agents import Agent\nfrom bondai.tools.search import DuckDuckGoSearchTool\nfrom bondai.tools.website import WebsiteQueryTool\nfrom bondai.tools.file import FileWriteTool\n\ntask = \"\"\"I want you to research the usage of Metformin as a drug to treat aging and aging related illness. \nYou should only use reputable information sources, ideally peer reviewed scientific studies. \nI want you to summarize your findings in a document named metformin.md and includes links to reference and resources you used to find the information. \nAdditionally, the last section of your document you should provide a recommendation for a 43 year old male, in good health and who regularly exercises as to whether he would benefit from taking Metformin. \nYou should explain your recommendation and justify it with sources. \nFinally, you should highlight potential risks and tradeoffs from taking the medication.\"\"\"\n\nAgent(tools=[\n  DuckDuckGoSearchTool(),\n  WebsiteQueryTool(),\n  FileWriteTool()\n]).run(task)\n```\n\n## BondAI Integrations\n\nBondAI comes out of the box with a powerful set of integrations.\n\n|     |  |  |\n| -------- | ------- |------- |\n| \u003cimg src=\"assets/logos/openai-logo.png\" alt=\"openai logo\" width=\"50\"/\u003e | **OpenAI**     | BondAI supports any combination of OpenAI models and services including GPT-4, GPT-3.5, Dalle-E 3, and Embeddings.  |\n| \u003cimg src=\"assets/logos/azure-logo.png\" alt=\"azure logo\" width=\"50\"/\u003e | **Microsoft Azure**     | BondAI fully supports connectivity to GPT-N, Dalle-E and Embedding APIs through [Microsoft's Azure OpenAI services](https://azure.microsoft.com/en-us/products/ai-services/openai-service).  |\n| \u003cimg src=\"assets/logos/google-logo.png\" alt=\"google logo\" width=\"50\"/\u003e  | **Google Search**    | Allows BondAI to search the internet. [Requires a Google Search API Key and CSE ID](https://developers.google.com/custom-search/v1/introduction) |\n| \u003cimg src=\"assets/logos/duckduckgo-logo.png\" alt=\"duckduckgo logo\" width=\"50\"/\u003e | **DuckDuckGo**     | Allows BondAI to search the internet. No API keys required. |\n| \u003cimg src=\"assets/logos/alpaca-markets-logo.jpeg\" alt=\"alpaca markets logo\" width=\"50\"/\u003e | **Alpaca Markets**     | Allows BondAI to buy and sell stocks and crypto. [Requires an Alpaca Markets account.](https://alpaca.markets/)  |\n| \u003cimg src=\"assets/logos/postgres-logo.jpeg\" alt=\"postgres logo\" width=\"75\"/\u003e    | **PostgreSQL**    | BondAI can automatically extract the schema from a Postgres DB and process natural language queries. |\n| \u003cimg src=\"assets/logos/blandai-logo.jpeg\" alt=\"bland.ai logo\" width=\"50\"/\u003e | **Bland AI**     | Allows BondAI to make phone calls and process/retrieve call transcripts. [Requires a Bland.ai account.](https://www.bland.ai/)  |\n| \u003cimg src=\"assets/logos/gmail-logo.png\" alt=\"gmail logo\" width=\"50\"/\u003e | **Gmail**     | Allows BondAI to search and read emails.  |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrohling%2Fbondai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkrohling%2Fbondai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrohling%2Fbondai/lists"}