{"id":25308796,"url":"https://github.com/yyaadet/llmsurf","last_synced_at":"2026-01-30T10:27:01.064Z","repository":{"id":276274461,"uuid":"928777305","full_name":"yyaadet/llmsurf","owner":"yyaadet","description":"An AI agent that can perform tasks on your macOS. It can open applications, search the web, and more.","archived":false,"fork":false,"pushed_at":"2025-03-05T02:26:39.000Z","size":3860,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-05T03:25:28.887Z","etag":null,"topics":["agent","ai","deep-research","deepseek-r1","macos","ollama","websearch-agent"],"latest_commit_sha":null,"homepage":"https://yyaadet.github.io/llmsurf/","language":"HTML","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/yyaadet.png","metadata":{"files":{"readme":"docs/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":"2025-02-07T08:13:05.000Z","updated_at":"2025-03-05T02:26:41.000Z","dependencies_parsed_at":"2025-03-06T09:03:00.003Z","dependency_job_id":null,"html_url":"https://github.com/yyaadet/llmsurf","commit_stats":null,"previous_names":["yyaadet/llmsurf"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yyaadet%2Fllmsurf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yyaadet%2Fllmsurf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yyaadet%2Fllmsurf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yyaadet%2Fllmsurf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yyaadet","download_url":"https://codeload.github.com/yyaadet/llmsurf/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247623009,"owners_count":20968574,"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","deep-research","deepseek-r1","macos","ollama","websearch-agent"],"created_at":"2025-02-13T12:35:44.084Z","updated_at":"2026-01-07T04:29:31.944Z","avatar_url":"https://github.com/yyaadet.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LLMSurf - Mining AI Agent For macOS\n\n![LLMSurf](https://raw.githubusercontent.com/yyaadet/llmsurf/main/images/llmsurf.jpeg)\n\nA Mining AI agent that can perform information mining on your macOS. It can search the Google, X, Reddit, Baidu freely etc, response with AI LLM, and check the LLM answer factually.\n\n## Cases\n\n- Super Researcher\n- Native search engine\n- Native knowledge library\n- Native R calculations\n- Customer Discovery\n- Data Mining\n\n## Features\n\n- Search freely\n- Factually check LLM answer\n- Embedded R runtime\n- Search the twitter(X), rednote(xiaohongshu.com), Reddit, Baidu, Weixin MP and Google etc\n- Answer questions with search results or local knowledges\n- Transform conversation to task. You can run the task with one click.\n- Support local native LLM models and cloud openai like models.\n- Prevent duplicated knowledges\n- Manage knowledges, delete knowledges, auto update knowledge, open knowledge in the local desktop and more\n\n## Installation\n\n### Install ollama\n\n1. Drag Ollama.app to /Applications\n2. Run Ollama\n\n\n### Install App\n\n1. Drag LLMSurf-v-xxx.app to /Applications\n2. Run LLMSurf\n\nSolve macOS App Opening Issue in One Minute! Fix the error: \"Apple cannot verify that 'App Cleaner \u0026 Uninstaller' does not contain malware that may harm your Mac or compromise your privacy.\"\n\n1. Open Terminal (press Command+Space and search for Terminal)\n2. Enter these two commands:\n\n```shell\nsudo spctl --master-disable\n\n#(navigate to the applications folder)\ncd /Applications \n\n# (use Tab key to auto-complete)\nsudo xattr -rd com.apple.quarantine /Applications/LLMSurf.app \n```\n3. Enter your user password\n4. Open Settings -\u003e Security \u0026 Privacy -\u003e Security -\u003e Allow Any developers\n5. Open LLMSurf\n\n![Allow Any developers](https://raw.githubusercontent.com/yyaadet/llmsurf/main/screenshots/privacy.png)\n\nDone!\n\n### Install models\n\nIf the app downloads models failed or the models are not in the App resources folder, we can download them and install them manually.\n\nYou can try download SentenceBERT model manually from [https://github.com/yyaadet/llmsurf/releases/download/v1.0.0/SentenceBERT.mlmodelc.zip].\n\n1. Unzip it. You can see a file named `SentenceBERT.mlmodelc`.\n2. Open the Terminal app. If your downloads are in the folder `~/Downloads`, you should run the command: `cd ~/Downloads`\n3. Run command in the terminal: `mkdir -p ~/Library/Application\\ Support/LLMSurf/Models/SentenceBERT`\n4. Run command in the terminal: `cp -rf SentenceBERT.mlmodelc ~/Library/Application\\ Support/LLMSurf/Models/SentenceBERT`\n\n\nDownload rerank model from [https://github.com/yyaadet/llmsurf/releases/download/v3.0.0/BGEReranker.mlmodelc.zip] .\n\n1. Unzip it. You can see a file named `BGEReranker.mlmodelc.zip`.\n2. Open the Terminal app. If your downloads are in the folder `~/Downloads`, you should run the command: `cd ~/Downloads`\n3. Run command in the terminal: `mkdir -p ~/Library/Application\\ Support/LLMSurf/Models/BGEReranker`\n4. Run command in the terminal: `cp -rf BGEReranker.mlmodelc ~/Library/Application\\ Support/LLMSurf/Models/BGEReranker`\n\n\nOf course, you can operate in GUI.\n\n**Or download from baidu disk**:\n\n链接: https://pan.baidu.com/s/1L2rWKGX0eDA_WeG_Mu19eA?pwd=t6jv 提取码: t6jv\n\n\n## Screenshots\n\n![Main](https://raw.githubusercontent.com/yyaadet/llmsurf/main/screenshots/main.png)\n\n![Main](https://raw.githubusercontent.com/yyaadet/llmsurf/main/screenshots/knowledge_manage.png)\n\n# LLM Response Check Factually\n\nLLMSurf can check the AI LLM response factually.\n\n1. We will show information citation in the LLM response.\n2. We will check the information citation factually.\n3. The numbers or claims in the LLM response will be checked factually.\n\n![LLM Response Check](https://raw.githubusercontent.com/yyaadet/llmsurf/main/screenshots/llm_response_check.png)\n\n## Contact US\n\n- Email: yyaadet@qq.com\n- Twitter: [yyaadet](https://twitter.com/yyaadet)\n- Wechat: yyaadet2002\n- GitHub: [yyaadet](https://github.com/yyaadet)\n\n## Recommendation\n\n- [AutoSRT](https://github.com/yyaadet/autosrt_page) is an macOS app that automatically generates dual language subtitles from video files.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyyaadet%2Fllmsurf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyyaadet%2Fllmsurf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyyaadet%2Fllmsurf/lists"}