{"id":20189458,"url":"https://github.com/jackfsuia/shampoosalesagent","last_synced_at":"2025-08-20T16:17:29.493Z","repository":{"id":231075744,"uuid":"780556937","full_name":"jackfsuia/ShampooSalesAgent","owner":"jackfsuia","description":"A minimal LLM sales agent framework for sales agent fast deployment and benchmark. Support OpenAI models, Claude, HuggingFace models, Gemini, Ernie(文心一言4.0), Baichuan(百川), Qwen(通义千问), Moonshot(月之暗面), GLM(智谱), Deepseek. AI销售智能体微型框架.","archived":false,"fork":false,"pushed_at":"2024-09-06T04:02:23.000Z","size":5227,"stargazers_count":15,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-24T08:07:08.373Z","etag":null,"topics":["agent","ai","framework","gpt","llm","machine-learning","nlp","recommendation-system","retail","salesperson","selling-platform","shampoo","shopping"],"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/jackfsuia.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-04-01T18:13:26.000Z","updated_at":"2025-03-03T08:51:23.000Z","dependencies_parsed_at":"2024-06-01T17:57:03.971Z","dependency_job_id":"51ad300c-baa9-4220-9003-ac2983af4b34","html_url":"https://github.com/jackfsuia/ShampooSalesAgent","commit_stats":null,"previous_names":["gogogo22/shampoosalesagent","jackfsuia/shampoosalesagent"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackfsuia%2FShampooSalesAgent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackfsuia%2FShampooSalesAgent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackfsuia%2FShampooSalesAgent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackfsuia%2FShampooSalesAgent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jackfsuia","download_url":"https://codeload.github.com/jackfsuia/ShampooSalesAgent/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248182024,"owners_count":21060892,"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","ai","framework","gpt","llm","machine-learning","nlp","recommendation-system","retail","salesperson","selling-platform","shampoo","shopping"],"created_at":"2024-11-14T03:37:22.507Z","updated_at":"2025-04-10T07:52:22.918Z","avatar_url":"https://github.com/jackfsuia.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ShampooSalesAgent\n\n### A minimal LLM Agent Framework for Sales Agent Fast Deployment and Benchmark \n\n[![license][license-image]][license-url]\n![GitHub Release](https://img.shields.io/github/v/release/jackfsuia/ShampooSalesAgent)\n\n[license-image]: http://img.shields.io/badge/license-MIT-blue.svg\n[license-url]: https://github.com/gogogo22/ShampooSalesAgent/blob/master/LICENSE\nEnglish | [简体中文](README_zh.md)\n\u003c/div\u003e\n\n- A LLM-powered **minimal** agent that sells Shampoo for a living. Fluent conversation with customers on Web and will record their orders in a local .csv [file](customer_orders.csv). \n\n- Support OpenAI models, HuggingFace models, Claude, Gemini, Baichuan, Qwen, Moonshot, Ernie, Glm, Deepseek.\n\n- Very friendly for beginners, researchers and businessman who want to try things out quick.\n #### Demo:\n\u003cimg src=\"image/e1.PNG\"\u003e\n\u003cimg src=\"image/e2.PNG\"\u003e\n\n## Updates\n- An proactive, experimental version is [Proactive-Sales-Agent](https://github.com/jackfsuia/Proactive-Sales-Agent).\n## Quick Start\nRun\n```bash\ngit clone https://github.com/jackfsuia/ShampooSalesAgent.git \u0026\u0026 cd ShampooSalesAgent\n```\nAfter installing the requirements (gradio, openai, etc). Run\n\n```bash\npython start.py MODEL YOUR_KEY\n```\nMODEL can be [gpt3.5/4](https://platform.openai.com/docs/models/overview), [claude](https://www.anthropic.com/api), [gemini](https://ai.google.dev/gemini-api/docs/api-key), [baichuan](https://platform.baichuan-ai.com/console/apikey), [qwen](https://help.aliyun.com/zh/dashscope/developer-reference/activate-dashscope-and-create-an-api-key), [kimi](https://platform.moonshot.cn/console/api-keys), [glm](https://open.bigmodel.cn/usercenter/apikeys), [deepseek](https://platform.deepseek.com/api_keys).YOUR_KEY is your model API KEY. If you don't have a KEY, click the link on those model names to apply/buy.\n\nBut if you're using [ernie](https://cloud.baidu.com/doc/WENXINWORKSHOP/s/clntwmv7t), you should instead run \n```bash\npython start.py MODEL API_Key Secret_Key\n```\nAPI_Key and Secret_Key are defined by ernie, please refer to their website.\n\nand if you're using [huggingface model](https://huggingface.co/welcome), just run \n```bash\npython start.py MODEL\n```\nThat's all!  \n\nIf you want to use CLI instead of web as interface, just use `start_CLI.py` instead of `start.py`.\n\nBy default, this agent proactively sells Shampoo. Write your own product information to [product_description](product_description) if you want to sell something else. The order infomation (name, address, phone number, purchase quantity, etc. provided by customers)  will be printed to [customer_orders.csv](customer_orders.csv). The mission prompt is in [normal_flow.py](chat_flow/normal_flow.py) in case you want to change it.\n\n## Examples\nLet's say you're using gpt-3.5-turbo as model, the KEY you bought is sdjkSOIjkdejs. Then you should be running\n```bash\npython start.py gpt-3.5-turbo sdjkSOIjkdejs\n```\nor for short ([a few models have short names](#Table))\n```bash\npython start.py gpt sdjkSOIjkdejs\n```\n*For [gradio](https://github.com/gradio-app/gradio) on Windows 10 to successfully work, you might have to download some mystery file that you have to turn off Windows Defender and add some folders to Defender exclusion list to do.*\n\nthen the ouput will be something like this\n```\npath\\ShampooSalesAgent\u003epython start.py gpt sdjkSOIjkdejs\nplease go to one of the following  links to chat, and the second link can be shared public. If the link crash during chat, please keep clicking the Retry button located at the bottom of the chat page. if \nyou need it to speak English, you can just say 'speak english' to it.(请点击以下任一网址进入聊天，第二个网址可以分享给其他人。聊天的时候崩溃请点聊天框下面的Retry按钮)\nRunning on local URL:  http://127.0.0.1:7860\nRunning on public URL: https://8fefa6c18e039476175.gradio.live\n\nThis share link expires in 72 hours. For free permanent hosting and GPU upgrades, run `gradio deploy` from Terminal to deploy to Spaces (https://huggingface.co/spaces)\n```\n\nBoth links work. Only the second link can be shared to public. Click the link, you'll see the web, and have a chat\n\n\u003cimg src=\"image/e1.PNG\"\u003e\n\u003cimg src=\"image/e2.PNG\"\u003e\n\nthe order infomation will be printed out to the CLI\n```\nThis share link expires in 72 hours. For free permanent hosting and GPU upgrades, run `gradio deploy` from Terminal to deploy to Spaces (https://huggingface.co/spaces)\n2024-04-02 13:52:01.748677 \u003cJack Oliver\u003e\u003c490 2nd St, Suite 300, New York\u003e\u003c212555-1212\u003e\u003c2 bottles\u003e\u003c30 USD\u003e\nCustomer order information has been written to customer_orders.csv\n```\nand [customer_orders.csv](customer_orders.csv). Open this .csv file, you'll see the order information line\n```\n2024-04-02 13:52:01.748677,Jack Oliver,\"490 2nd St, Suite 300, New York\",212555-1212,2 bottles,30 USD\n```\nhas been added.\n\n *Do you like this project? Give us a :star:*\n \n## Model Evaluation—Who is the Sales Champion?\n\nRun \n```bash\npython order_counting.py\n```\nyou will find out. You can share your interesting results on this benchmark with us all.\n\n## Future Work\n- Finetune the model to be more professional at selling things, and talk more natural just like human. It is important to make people feel connections with each other, even with a robot (like the movie, *her*). 99% of people are not complex reasoning machines, but almost every one of them can make us feel warm and support at some point in life.\n- Support multimodal models. This might be simpler and soon.\n  \n## License\n\nShampooSalesAgent is licensed under the MIT License found in the [LICENSE](LICENSE) file in the root directory of this repository.\n\n## Citation\n\nIf this work is helpful, please kindly cite as:\n\n```bibtex\n@article{ShampooSalesAgent,\n  title={ShampooSalesAgent: A minimal LLM Sales Agent Framework for Sales Agent Fast Deployment and Benchmark}, \n  author={Yannan Luo},\n  year={2024},\n  url={https://github.com/gogogo22/ShampooSalesAgent}\n}\n```\n## Acknowledgement\n\nThis repo benefits from [gradio](https://github.com/gradio-app/gradio), and the free models I have been using: [baichuan](https://platform.baichuan-ai.com/console/apikey), [qwen](https://help.aliyun.com/zh/dashscope/developer-reference/activate-dashscope-and-create-an-api-key), [kimi](https://platform.moonshot.cn/console/api-keys), [huggingface model](https://huggingface.co/welcome). Thanks for their wonderful works. Thank [gpt3.5/4](https://platform.openai.com/docs/models/overview) for open the imagination. \n\n## Table\nA few models have short names.\n\nFull Name| Short Name\n-|-\ngpt-3.5-turbo|gpt\ngemini-pro|gemini\nclaude-3-opus-20240229|claude\nmoonshot-v1-8k|kimi\nqwen1.5-72b-chat|qwen\nBaichuan2-Turbo|baichuan\nERNIE-4.0-8K|ernie\nglm-4|glm\ndeepseek-chat|deepseek\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackfsuia%2Fshampoosalesagent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjackfsuia%2Fshampoosalesagent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackfsuia%2Fshampoosalesagent/lists"}