{"id":31936218,"url":"https://github.com/ibz-04/seeker","last_synced_at":"2025-10-14T07:25:15.163Z","repository":{"id":283882406,"uuid":"953177901","full_name":"iBz-04/Seeker","owner":"iBz-04","description":"Your personal deep research ai agent","archived":false,"fork":false,"pushed_at":"2025-05-09T14:27:31.000Z","size":43,"stargazers_count":23,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-04T19:36:03.414Z","etag":null,"topics":["agentic-ai","ai-agents","autonomous-agents","deep-research","deepresearch","deepseek-r1","firecrawl","fireworksai","langchain","llm","nlp","o3-mini","open-deep-research","open-source","openai","research-agent","research-ai","research-assistant","research-tool","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/iBz-04.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"citation.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-22T18:42:35.000Z","updated_at":"2025-08-14T00:32:49.000Z","dependencies_parsed_at":"2025-04-06T23:20:00.101Z","dependency_job_id":"695d6e20-3c4a-4f97-8acc-e20477ccfcab","html_url":"https://github.com/iBz-04/Seeker","commit_stats":null,"previous_names":["ibz-04/seeker-"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iBz-04/Seeker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2FSeeker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2FSeeker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2FSeeker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2FSeeker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iBz-04","download_url":"https://codeload.github.com/iBz-04/Seeker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2FSeeker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018215,"owners_count":26086303,"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","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["agentic-ai","ai-agents","autonomous-agents","deep-research","deepresearch","deepseek-r1","firecrawl","fireworksai","langchain","llm","nlp","o3-mini","open-deep-research","open-source","openai","research-agent","research-ai","research-assistant","research-tool","typescript"],"created_at":"2025-10-14T07:25:13.714Z","updated_at":"2025-10-14T07:25:15.156Z","avatar_url":"https://github.com/iBz-04.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003ch1\u003eSeeker Ai\u003c/h1\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\" style=\"margin-top: 10px\"\u003e\n  \u003ca href=\"\"\u003e\n    \u003cimg\n      src=\"https://res.cloudinary.com/diekemzs9/image/upload/v1746009112/extension_icon_1024px_jedbgf.png\"\n      alt=\"seeker\"\n      height=\"100\"\n    /\u003e\n  \u003c/a\u003e\n\nA local research assistant that performs iterative, deep-dive investigations using search engines, web scraping, and LLMs. Combines breadth-first exploration with depth-first analysis for comprehensive topic coverage.\n\n### Clariciation of Search Intent\n![Research Process Diagram](https://res.cloudinary.com/diekemzs9/image/upload/v1742669225/Screenshot_2025-03-22_181603_cl5rgp.png)\n\n### Research Process\n![Research Process Diagram](https://res.cloudinary.com/diekemzs9/image/upload/v1742669225/Screenshot_2025-03-22_181656_bfcrwe.png)\n\n### End of Task\n![Research Process Diagram](https://res.cloudinary.com/diekemzs9/image/upload/v1742669225/Screenshot_2025-03-22_181734_zdoaku.png)\n\n\n## Features \n\n- **Iterative Research** - Self-refining research direction based on initial findings\n- **Follow-up Question System** - Clarifies research goals through interactive dialogue\n- **Configurable Parameters** - Control research breadth (3-10) and depth (1-5)\n- **Multi-format Output** - Generates detailed reports or concise answers\n- **LLM Agnostic** - Supports OpenAI, Fireworks.ai, and local LLMs via custom endpoints\n- **Concurrent Processing** - Parallelizes research tasks for faster results\n\n## Quick Start 🚀\n\n### Prerequisites\n- Node.js v18+\n- API keys for:\n  - [Firecrawl](https://firecrawl.dev/) (web scraping)\n  - [OpenAI](https://openai.com/) or [Fireworks.ai](https://fireworks.ai/)\n\n```bash\n# Clone repository\ngit clone https://github.com/iBz-04/Seeker.git\ncd Seeker\n\n# Install dependencies\nnpm install\n\n# Configure environment\ncp .env.example .env.local\n# Edit .env.local with your API keys\n```\n\n### Basic Usage\n```bash\nnpm start\n\n? What would you like to research? Effects of climate change on coffee production\n? Research breadth (3-10): 5\n? Research depth (1-5): 2\n```\n\n## Advanced Configuration ⚙️\n\n### Environment Variables\n```ini\n# Required\nFIRECRAWL_API_KEY=\"your_firecrawl_key\"\nOPENAI_API_KEY=\"your_openai_key\"  # OR\nFIREWORKS_API_KEY=\"your_fireworks_key\"\n\n# Optional\nRESEARCH_CONCURRENCY=5  # Parallel requests\nMAX_TOKENS=4096         # LLM context window\n```\n\n### Docker Deployment\n```bash\ndocker compose up -d --build\ndocker exec -it deep-research npm run docker\n```\n\n## Research Process Flow 🔄\n\n1. **Initial Query Analysis**\n   - Parse user's research question\n   - Generate clarifying follow-up questions\n   - Collect additional context through interactive Q\u0026A\n\n2. **Search Strategy Development**\n   - Generate multiple search queries based on research goals\n   - Prioritize queries using relevance scoring\n   - Execute parallel web searches using Firecrawl\n\n3. **Content Analysis**\n   - Extract key insights from web content\n   - Maintain context-aware knowledge graph\n   - Identify promising research directions for deep-dive\n\n4. **Recursive Exploration**\n   - Repeat search/analysis process at specified depth\n   - Prune irrelevant branches\n   - Merge findings across iterations\n\n5. **Report Generation**\n   - Synthesize findings into structured markdown\n   - Include sources and confidence ratings\n   - Generate both technical and executive summaries\n\n## Customization Options 🛠️\n\n### Adjust Research Parameters\n```typescript\n// deep-research.ts\nconst config = {\n  maxConcurrency: 5,      // Parallel requests\n  minRelevanceScore: 0.7, // Content filtering threshold\n  maxPagesPerQuery: 10,   // Resource limits\n  timeout: 30000          // Per-request timeout\n};\n```\n\n### Supported LLM Providers\n```ini\n# Local AI\nOPENAI_BASE_URL=\"http://localhost:1234/v1\"\nOPENAI_MODEL=\"your-local-model\"\n\n# OpenRouter\nOPENAI_BASE_URL=\"https://openrouter.ai/api/v1\"\nOPENAI_MODEL=\"anthropic/claude-3-haiku\"\n```\n\n## Example Output 📄\n\n```markdown\n# Research Report: Climate Change Impact on Coffee Production\n\n## Key Findings\n- **Yield Reductions**: 50% projected decrease in suitable growing areas by 2050\n- **Quality Impacts**: Increased temperatures correlate with flavor profile degradation\n- **Economic Costs**: $2.5B annual losses anticipated in major producing regions\n\n## Recommended Actions\n1. Develop heat-resistant coffee cultivars\n2. Implement agroforestry practices\n3. Diversify geographic production areas\n\n## Sources\n1. [Journal of Agricultural Science] (https://example.com/source1)\n2. [FAO Climate Report] (https://example.com/source2)\n```\n\n## Troubleshooting ⚠️\n\n**Common Issues:**\n- Rate Limiting: Reduce `RESEARCH_CONCURRENCY` in free tier\n- Timeouts: Increase `TIMEOUT` duration for complex queries\n- Relevance Filtering: Adjust `MIN_RELEVANCE_SCORE` for sensitive content\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibz-04%2Fseeker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fibz-04%2Fseeker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibz-04%2Fseeker/lists"}