# 🚀 CrazyContext
**The ultimate context builder for LLM applications**
Multi-source context gathering (web, papers, GitHub) with optional semantic search integration.
[](https://opensource.org/licenses/Apache-2.0)
[](https://www.python.org/downloads/)
---
## ✨ Features
- 🌐 **Multi-Source Gathering** - Web, academic papers, GitHub repos, local files
- 🔍 **Flexible Search** - Keyword, fuzzy, or semantic (with Deep-Searcher)
- 📚 **GitHub Integration** - Search repos, download code, extract context
- 📄 **Format Flexibility** - HTML, Markdown, PDF, plain text
- 💾 **Smart Caching** - Download once, query forever
- 🎯 **Profile System** - Pre-optimized for research, coding, legal, etc.
- 🤖 **LLM-Ready** - Direct output for any LLM (no framework lock-in)
- 🔌 **Optional Semantic Search** - Integrate with Deep-Searcher when needed
---
## 🚀 Quick Start
### Installation
```bash
# Core installation
pip install crazycontext
# With optional features
pip install crazycontext[fuzzy] # Fuzzy search
pip install crazycontext[pdf] # PDF support
pip install crazycontext[github] # GitHub integration
pip install crazycontext[deepsearcher] # Semantic search
pip install crazycontext[all] # Everything
```
### Basic Usage
```python
from crazycontext import CrazyContext
# Initialize
cc = CrazyContext()
# Gather context from multiple sources
context = cc.from_topic(
"machine learning",
sources=["web", "papers", "github"],
max_results=20
)
# Format for LLM
prompt = context.build(format="llm_prompt")
print(prompt)
```
---
## 📖 Examples
### Download Documentation
```python
# Download and convert to Markdown
cc.from_urls([
"https://docs.python.org/3/tutorial/",
"https://pytorch.org/tutorials/"
])
# Search downloaded content
results = cc.search("neural networks", search_type="keyword")
```
### Academic Papers
```python
# Fetch papers from arXiv, Semantic Scholar
context = cc.from_topic(
"transformer attention mechanisms",
sources=["papers"],
max_results=10
)
```
### GitHub Repositories
```python
# Search and download GitHub repos
context = cc.from_topic(
"pytorch neural networks",
sources=["github"],
github_options={
"language": "python",
"min_stars": 500
}
)
```
### Semantic Search (Optional)
```python
from crazycontext.bridges import CrazyContextLoader
# Initialize with Deep-Searcher integration
loader = CrazyContextLoader()
# Gather with CrazyContext, search with Deep-Searcher
loader.load_from_crazycontext(
topic="AI",
sources=["web", "papers", "github"]
)
# Semantic query (uses FREE Gemini embeddings!)
answer = loader.query("What is deep learning?")
print(answer['answer'])
```
---
## 🎯 Use Cases
- **Research** - Gather papers, web articles, and code examples
- **Documentation** - Download and search technical docs
- **Coding Assistants** - GitHub code examples + documentation
- **Knowledge Bases** - Multi-source context for RAG systems
- **Content Creation** - Research and fact-checking
---
## 📚 Documentation
### 🎯 Start Here
- **[Getting Started Guide](./docs/GETTING_STARTED.md)** - Installation, quick start, basic concepts
- **[Examples](./docs/EXAMPLES.md)** - Real-world use cases
- **[CLI Guide](./docs/CLI_GUIDE.md)** - Command-line interface
### 📖 Reference
- **[API Reference](./docs/API_REFERENCE.md)** - Complete API documentation
- **[Best Practices](./docs/BEST_PRACTICES.md)** - Guidelines and recommendations
- **[llm.txt](./llm.txt)** - LLM-optimized reference for AI assistants
### 📋 Full Documentation
- **[Documentation Index](./docs/README.md)** - Complete documentation overview
### 🗺️ Architecture & Design
- [Unification Plan](../CRAZYCONTEXT_UNIFICATION_PLAN.md) - Architecture & design
- [Quick Reference](../CRAZYCONTEXT_QUICK_REFERENCE.md) - API cheatsheet
- [GitHub Integration](../CRAZYCONTEXT_GITHUB_SOURCE.md) - GitHub features
- [Deep-Searcher Bridge](../CRAZYCONTEXT_AS_DEEPSEARCHER_LOADER.md) - Semantic search
---
## 🔧 Development
```bash
# Clone repository
git clone https://github.com/crazycontext/crazycontext.git
cd crazycontext
# Install in development mode
pip install -e .[dev]
# Run tests
pytest
# Format code
black crazycontext/
```
---
## 🤝 Contributing
Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) first.
---
## 📄 License
Apache 2.0 - see [LICENSE](LICENSE) file for details.
---
## 🌟 Features Comparison
| Feature | CrazyContext Alone | + Deep-Searcher Bridge |
|---------|-------------------|----------------------|
| Multi-source gather | ✅ | ✅ |
| Keyword search | ✅ | ✅ |
| Fuzzy search | ✅ | ✅ |
| Semantic search | ❌ | ✅ |
| GitHub integration | ✅ | ✅ |
| Cost | Free | ~$0.001-0.01/query |
| Setup | Simple | Moderate |
---
## 💡 Why CrazyContext?
- **Simple** - Works out of the box, no complex setup
- **Flexible** - Use standalone or with semantic search
- **Cost-effective** - Free core, optional paid features
- **No lock-in** - Works with any LLM framework
- **Production-ready** - Battle-tested, well-documented
---
**Built with ❤️ for the LLM community**
*Making context building crazy simple!* 🎯
Raw data
{
"_id": null,
"home_page": null,
"name": "crazycontext",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "llm, context, rag, semantic-search, web-scraping, papers, github",
"author": "CrazyContext Team",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/5c/23/6f275be30af398ee435251ec28e10b3efd626e6756d1ef01b02fad6d8617/crazycontext-0.1.0.tar.gz",
"platform": null,
"description": "# \ud83d\ude80 CrazyContext\r\n\r\n**The ultimate context builder for LLM applications**\r\n\r\nMulti-source context gathering (web, papers, GitHub) with optional semantic search integration.\r\n\r\n[](https://opensource.org/licenses/Apache-2.0)\r\n[](https://www.python.org/downloads/)\r\n\r\n---\r\n\r\n## \u2728 Features\r\n\r\n- \ud83c\udf10 **Multi-Source Gathering** - Web, academic papers, GitHub repos, local files\r\n- \ud83d\udd0d **Flexible Search** - Keyword, fuzzy, or semantic (with Deep-Searcher)\r\n- \ud83d\udcda **GitHub Integration** - Search repos, download code, extract context\r\n- \ud83d\udcc4 **Format Flexibility** - HTML, Markdown, PDF, plain text\r\n- \ud83d\udcbe **Smart Caching** - Download once, query forever\r\n- \ud83c\udfaf **Profile System** - Pre-optimized for research, coding, legal, etc.\r\n- \ud83e\udd16 **LLM-Ready** - Direct output for any LLM (no framework lock-in)\r\n- \ud83d\udd0c **Optional Semantic Search** - Integrate with Deep-Searcher when needed\r\n\r\n---\r\n\r\n## \ud83d\ude80 Quick Start\r\n\r\n### Installation\r\n\r\n```bash\r\n# Core installation\r\npip install crazycontext\r\n\r\n# With optional features\r\npip install crazycontext[fuzzy] # Fuzzy search\r\npip install crazycontext[pdf] # PDF support\r\npip install crazycontext[github] # GitHub integration\r\npip install crazycontext[deepsearcher] # Semantic search\r\npip install crazycontext[all] # Everything\r\n```\r\n\r\n### Basic Usage\r\n\r\n```python\r\nfrom crazycontext import CrazyContext\r\n\r\n# Initialize\r\ncc = CrazyContext()\r\n\r\n# Gather context from multiple sources\r\ncontext = cc.from_topic(\r\n \"machine learning\",\r\n sources=[\"web\", \"papers\", \"github\"],\r\n max_results=20\r\n)\r\n\r\n# Format for LLM\r\nprompt = context.build(format=\"llm_prompt\")\r\nprint(prompt)\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udcd6 Examples\r\n\r\n### Download Documentation\r\n\r\n```python\r\n# Download and convert to Markdown\r\ncc.from_urls([\r\n \"https://docs.python.org/3/tutorial/\",\r\n \"https://pytorch.org/tutorials/\"\r\n])\r\n\r\n# Search downloaded content\r\nresults = cc.search(\"neural networks\", search_type=\"keyword\")\r\n```\r\n\r\n### Academic Papers\r\n\r\n```python\r\n# Fetch papers from arXiv, Semantic Scholar\r\ncontext = cc.from_topic(\r\n \"transformer attention mechanisms\",\r\n sources=[\"papers\"],\r\n max_results=10\r\n)\r\n```\r\n\r\n### GitHub Repositories\r\n\r\n```python\r\n# Search and download GitHub repos\r\ncontext = cc.from_topic(\r\n \"pytorch neural networks\",\r\n sources=[\"github\"],\r\n github_options={\r\n \"language\": \"python\",\r\n \"min_stars\": 500\r\n }\r\n)\r\n```\r\n\r\n### Semantic Search (Optional)\r\n\r\n```python\r\nfrom crazycontext.bridges import CrazyContextLoader\r\n\r\n# Initialize with Deep-Searcher integration\r\nloader = CrazyContextLoader()\r\n\r\n# Gather with CrazyContext, search with Deep-Searcher\r\nloader.load_from_crazycontext(\r\n topic=\"AI\",\r\n sources=[\"web\", \"papers\", \"github\"]\r\n)\r\n\r\n# Semantic query (uses FREE Gemini embeddings!)\r\nanswer = loader.query(\"What is deep learning?\")\r\nprint(answer['answer'])\r\n```\r\n\r\n---\r\n\r\n## \ud83c\udfaf Use Cases\r\n\r\n- **Research** - Gather papers, web articles, and code examples\r\n- **Documentation** - Download and search technical docs\r\n- **Coding Assistants** - GitHub code examples + documentation\r\n- **Knowledge Bases** - Multi-source context for RAG systems\r\n- **Content Creation** - Research and fact-checking\r\n\r\n---\r\n\r\n## \ud83d\udcda Documentation\r\n\r\n### \ud83c\udfaf Start Here\r\n- **[Getting Started Guide](./docs/GETTING_STARTED.md)** - Installation, quick start, basic concepts\r\n- **[Examples](./docs/EXAMPLES.md)** - Real-world use cases\r\n- **[CLI Guide](./docs/CLI_GUIDE.md)** - Command-line interface\r\n\r\n### \ud83d\udcd6 Reference\r\n- **[API Reference](./docs/API_REFERENCE.md)** - Complete API documentation\r\n- **[Best Practices](./docs/BEST_PRACTICES.md)** - Guidelines and recommendations\r\n- **[llm.txt](./llm.txt)** - LLM-optimized reference for AI assistants\r\n\r\n### \ud83d\udccb Full Documentation\r\n- **[Documentation Index](./docs/README.md)** - Complete documentation overview\r\n\r\n### \ud83d\uddfa\ufe0f Architecture & Design\r\n- [Unification Plan](../CRAZYCONTEXT_UNIFICATION_PLAN.md) - Architecture & design\r\n- [Quick Reference](../CRAZYCONTEXT_QUICK_REFERENCE.md) - API cheatsheet\r\n- [GitHub Integration](../CRAZYCONTEXT_GITHUB_SOURCE.md) - GitHub features\r\n- [Deep-Searcher Bridge](../CRAZYCONTEXT_AS_DEEPSEARCHER_LOADER.md) - Semantic search\r\n\r\n---\r\n\r\n## \ud83d\udd27 Development\r\n\r\n```bash\r\n# Clone repository\r\ngit clone https://github.com/crazycontext/crazycontext.git\r\ncd crazycontext\r\n\r\n# Install in development mode\r\npip install -e .[dev]\r\n\r\n# Run tests\r\npytest\r\n\r\n# Format code\r\nblack crazycontext/\r\n```\r\n\r\n---\r\n\r\n## \ud83e\udd1d Contributing\r\n\r\nContributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) first.\r\n\r\n---\r\n\r\n## \ud83d\udcc4 License\r\n\r\nApache 2.0 - see [LICENSE](LICENSE) file for details.\r\n\r\n---\r\n\r\n## \ud83c\udf1f Features Comparison\r\n\r\n| Feature | CrazyContext Alone | + Deep-Searcher Bridge |\r\n|---------|-------------------|----------------------|\r\n| Multi-source gather | \u2705 | \u2705 |\r\n| Keyword search | \u2705 | \u2705 |\r\n| Fuzzy search | \u2705 | \u2705 |\r\n| Semantic search | \u274c | \u2705 |\r\n| GitHub integration | \u2705 | \u2705 |\r\n| Cost | Free | ~$0.001-0.01/query |\r\n| Setup | Simple | Moderate |\r\n\r\n---\r\n\r\n## \ud83d\udca1 Why CrazyContext?\r\n\r\n- **Simple** - Works out of the box, no complex setup\r\n- **Flexible** - Use standalone or with semantic search\r\n- **Cost-effective** - Free core, optional paid features\r\n- **No lock-in** - Works with any LLM framework\r\n- **Production-ready** - Battle-tested, well-documented\r\n\r\n---\r\n\r\n**Built with \u2764\ufe0f for the LLM community**\r\n\r\n*Making context building crazy simple!* \ud83c\udfaf\r\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "The ultimate context builder for LLM applications - multi-source gathering (web, papers, GitHub) with optional semantic search",
"version": "0.1.0",
"project_urls": {
"Documentation": "https://github.com/crazycontext/crazycontext/blob/main/README.md",
"Homepage": "https://github.com/crazycontext/crazycontext",
"Issues": "https://github.com/crazycontext/crazycontext/issues",
"Repository": "https://github.com/crazycontext/crazycontext"
},
"split_keywords": [
"llm",
" context",
" rag",
" semantic-search",
" web-scraping",
" papers",
" github"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6954ba9094c9e789db3af1bd980c277c7afef6dbdba0077a1094babf17dc7514",
"md5": "7401996be57533815d28b423fd554679",
"sha256": "1dc6080ed24ab5ef6c296575f23aa38a2f32afdcfde64b28f58110fc6f444f83"
},
"downloads": -1,
"filename": "crazycontext-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7401996be57533815d28b423fd554679",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 53714,
"upload_time": "2025-10-30T17:39:29",
"upload_time_iso_8601": "2025-10-30T17:39:29.099794Z",
"url": "https://files.pythonhosted.org/packages/69/54/ba9094c9e789db3af1bd980c277c7afef6dbdba0077a1094babf17dc7514/crazycontext-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5c236f275be30af398ee435251ec28e10b3efd626e6756d1ef01b02fad6d8617",
"md5": "9688befe9734fd717366c4cc7775f6be",
"sha256": "95695d88a0b00ed7ea540a0d5f1a06060835bd48a916f88f1b0c628023670ed3"
},
"downloads": -1,
"filename": "crazycontext-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "9688befe9734fd717366c4cc7775f6be",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 81484,
"upload_time": "2025-10-30T17:39:31",
"upload_time_iso_8601": "2025-10-30T17:39:31.066622Z",
"url": "https://files.pythonhosted.org/packages/5c/23/6f275be30af398ee435251ec28e10b3efd626e6756d1ef01b02fad6d8617/crazycontext-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-30 17:39:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "crazycontext",
"github_project": "crazycontext",
"github_not_found": true,
"lcname": "crazycontext"
}
JSON
