{"id":28821529,"url":"https://github.com/blacktechx011/openwebresearcher","last_synced_at":"2025-07-31T13:37:41.809Z","repository":{"id":270196971,"uuid":"909602833","full_name":"BlackTechX011/OpenWebResearcher","owner":"BlackTechX011","description":"Open Web Researcher: is a cutting-edge, AI-powered alternative to tools like SearchGPT and Perplexity. It simplifies web research by refining queries, extracting key information, summarizing complex topics, and generating well-structured reports—all delivered in a convenient Markdown format. ","archived":false,"fork":false,"pushed_at":"2024-12-29T09:11:36.000Z","size":16,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-29T09:25:21.890Z","etag":null,"topics":["ai","ai-agents","ai-agents-framework","artificial-intelligence","blacktechx","blacktechx011","llm","perpexlity","python","searchgpt","web-search-agent","websearch"],"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/BlackTechX011.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-12-29T08:05:44.000Z","updated_at":"2024-12-29T09:11:39.000Z","dependencies_parsed_at":"2024-12-29T09:25:27.006Z","dependency_job_id":"bb2d988d-f0ec-4b7c-b8fd-c5d6770d0a3f","html_url":"https://github.com/BlackTechX011/OpenWebResearcher","commit_stats":null,"previous_names":["blacktechx011/openwebresearcher"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BlackTechX011/OpenWebResearcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackTechX011%2FOpenWebResearcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackTechX011%2FOpenWebResearcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackTechX011%2FOpenWebResearcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackTechX011%2FOpenWebResearcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BlackTechX011","download_url":"https://codeload.github.com/BlackTechX011/OpenWebResearcher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackTechX011%2FOpenWebResearcher/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260647642,"owners_count":23041692,"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":["ai","ai-agents","ai-agents-framework","artificial-intelligence","blacktechx","blacktechx011","llm","perpexlity","python","searchgpt","web-search-agent","websearch"],"created_at":"2025-06-18T22:45:54.162Z","updated_at":"2025-07-31T13:37:41.791Z","avatar_url":"https://github.com/BlackTechX011.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n# ✨ **Open Web Researcher** ✨  \n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/BlackTechX011/OpenWebResearcher?style=for-the-badge\u0026logo=github\u0026color=yellow\" alt=\"GitHub stars\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/forks/BlackTechX011/OpenWebResearcher?style=for-the-badge\u0026logo=github\u0026color=green\" alt=\"GitHub forks\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/issues/BlackTechX011/OpenWebResearcher?style=for-the-badge\u0026logo=github\u0026color=red\" alt=\"GitHub issues\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/BlackTechX011/OpenWebResearcher?style=for-the-badge\u0026logo=apache\" alt=\"GitHub license\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/last-commit/BlackTechX011/OpenWebResearcher?style=for-the-badge\u0026logo=git\u0026color=purple\" alt=\"Last commit\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Status-Active-brightgreen?style=for-the-badge\u0026logo=github-actions\" alt=\"Project status\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Platform-Cross--platform-lightgrey?style=for-the-badge\u0026logo=windows\" alt=\"Platform\"\u003e\n\u003c/p\u003e\n\n```\n ██████╗ ██████╗ ███████╗███╗   ██╗    ██╗    ██╗███████╗██████╗     ██████╗ ███████╗███████╗███████╗ █████╗ ██████╗  ██████╗██╗  ██╗███████╗██████╗ \n██╔═══██╗██╔══██╗██╔════╝████╗  ██║    ██║    ██║██╔════╝██╔══██╗    ██╔══██╗██╔════╝██╔════╝██╔════╝██╔══██╗██╔══██╗██╔════╝██║  ██║██╔════╝██╔══██╗\n██║   ██║██████╔╝█████╗  ██╔██╗ ██║    ██║ █╗ ██║█████╗  ██████╔╝    ██████╔╝█████╗  ███████╗█████╗  ███████║██████╔╝██║     ███████║█████╗  ██████╔╝\n██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║    ██║███╗██║██╔══╝  ██╔══██╗    ██╔══██╗██╔══╝  ╚════██║██╔══╝  ██╔══██║██╔══██╗██║     ██╔══██║██╔══╝  ██╔══██╗\n╚██████╔╝██║     ███████╗██║ ╚████║    ╚███╔███╔╝███████╗██████╔╝    ██║  ██║███████╗███████║███████╗██║  ██║██║  ██║╚██████╗██║  ██║███████╗██║  ██║\n ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝     ╚══╝╚══╝ ╚══════╝╚═════╝     ╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝\n```\n---\n\n## 🌐 **Overview**  \n\n**Open Web Researcher** 🤖 is an **AI-powered research companion** that automates web research, delivering concise and insightful reports. Using state-of-the-art **Large Language Models (LLMs)**, this tool refines queries, extracts content, and generates structured reports in Markdown format, making your research process seamless and efficient.  \n\n---\n\n## 🌟 **Key Features**  \n\n### 🚀 **Automated Web Research**  \nPerform in-depth, efficient web searches tailored to your queries.  \n\n### 📊 **Highly Detailed Report Generation**  \nGenerate comprehensive, structured, and insightful reports effortlessly.  \n\n### 🔍 **Deep Dive into Any Topic**  \nUnlock a profound understanding of complex subjects with expert-level analysis.  \n\n### 💾 **Markdown Export**  \nCreate shareable, easy-to-read Markdown reports perfect for collaboration and presentation.  \n\n### 💡 **The Best Free, Open-Source Alternative**  \nA superior, cost-free alternative to tools like SearchGPT and Perplexity.  \n\n### 🎯 **...And More!**  \nPacked with additional features to revolutionize your web research experience.  \n\n---\n\n## 🛠️ **Installation**  \n\n### 1️⃣ Clone the Repository:  \n```bash  \ngit clone https://github.com/BlackTechX011/OpenWebResearcher.git  \ncd OpenWebResearcher  \n```  \n\n### 2️⃣ Install Dependencies:  \n```bash  \npip install -r requirements.txt  \n```  \n\n### 3️⃣ Configure API Keys:  \nUpdate `config/settings.py` with your API keys:  \n```python  \n# --- Configuration ---  \nAPI_KEYS = [\"YOUR_FIRST_API_KEY\", \"YOUR_SECOND_API_KEY\"]  \nFINAL_REPORT_MODEL_API_KEY = \"YOUR_FINAL_REPORT_API_KEY\"  \n```\n\u003e [!NOTE]\n\u003e You can get your API keys from [https://aistudio.google.com/apikey](https://aistudio.google.com/apikey)\n\n---\n\n## 🎮 **Usage**  \n\n1. Run the script:  \n    ```bash  \n    python OpenWebResearcher.py  \n    ```  \n2. Enter your query when prompted.  \n3. Relax as Open Web Researcher delivers a beautifully formatted report.  \n\n---\n\n## 📊 **How It Works**  \n\n\n\n```\n+-------------------------+\n|       🚀 START          |\n+-------------------------+\n\n            👇\n+-------------------------+\n| 1. QUERY REFINEMENT     |\n|    Expand into          |\n|    subtopics            |\n+-------------------------+\n            👇\n+-------------------------+\n|   2. WEB SEARCH         |\n|   Extensive search      |\n|   per subtopic          |\n+-------------------------+\n            👇\n+-------------------------+\n| 3. CONTENT EXTRACTION   |\n|   Extract essence from  |\n|   relevant pages        |\n+-------------------------+\n            👇\n+-------------------------+\n|  4. SUMMARIZATION       |\n|   Use LLMs for key      |\n|   points                |\n+-------------------------+\n            👇\n+-------------------------+\n| 5. REPORT GENERATION    |\n|   Combine into an       |\n|   insightful report     |\n+-------------------------+\n            👇\n+-------------------------+\n| 6. MARKDOWN EXPORT      |\n|   Deliver in            |\n|   Markdown format       |\n+-------------------------+\n            👇\n+-------------------------+\n|        🎉 END          |\n+-------------------------+\n```\n\n---\n\n## 🤝 **Contributing**  \n\nWe welcome contributions! 🚀 Follow these steps:  \n1. Fork the repository.  \n2. Create a new branch for your feature or bug fix.  \n3. Make changes and commit them.  \n4. Submit a pull request.  \n\n---\n\n## 📜 **License**  \n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.  \n\n---\n\n## 📫 **Contact**  \n  \n\n- **GitHub:** [BlackTechX011](https://github.com/BlackTechX011)  \n\n\n---\n\n### 🚀 **Let Open Web Researcher transform your research process!**  \n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblacktechx011%2Fopenwebresearcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblacktechx011%2Fopenwebresearcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblacktechx011%2Fopenwebresearcher/lists"}