# AuxKnow 🛸
<p align="center"><img src="https://i.ibb.co/8mX2Cqm/cover-art.png" width="230" alt="Khoj Logo"></p>
<div align="center">
[](#license)
[](https://www.python.org/)
[](#contributors)
</div>
<div align="center">
<b>Answer Engines, everywhere.</b>
</div>
<br />
<div align="center">
[đź’ˇ Docs](https://the-hackers-playbook.gitbook.io/auxknow)
<span> • </span>
[🕸️ Web](https://auxknow.io)
<span> • </span>
</div>
AuxKnow is an advanced, state-of-the-art, fully customizable Answer Engine library, built to streamline the integration of intelligent answering capabilities into your applications. With AuxKnow, you can deploy feature-rich Answer Engines with minimal effort. For detailed guidance, refer to the [**Usage Instructions**](https://the-hackers-playbook.gitbook.io/auxknow/usage) section in the documentation.
---
## Background
At _The Hackers Playbook_, we are committed to building cutting-edge AI infrastructure and platforms grown out of Bharat (India). AuxKnow represents a significant milestone in our mission to deliver robust, developer-friendly tools for crafting AI-driven solutions. We encourage you to explore, innovate, and share your insights to help us improve and evolve. We look forward to your participation in our mission, since we are largely community driven and believe in Open Source culture.
AuxKnow leverages the capabilities of [Perplexity’s Sonar models](https://sonar.perplexity.ai/) to enable seamless integration of "Answer Engine" functionality. While Perplexity’s models provide the foundational technology, AuxKnow bridges the gap by delivering a highly configurable and user-friendly library to accelerate application development.
---
## Key Features
- **Fully Customizable**: Configure AuxKnow to align perfectly with your application’s requirements. Its flexibility ensures it can adapt to various use cases, from simple Q&A to complex contextual reasoning.
- **Dynamic Query Routing**: Automatically route user queries to the most appropriate model, ensuring optimal performance and accuracy.
- **Intelligent Query Restructuring**: AuxKnow restructures user queries to improve response quality, delivering more accurate and relevant answers.
- **Contextual Search**: AuxKnow can either leverage predefined contexts or autonomously build its own context to ensure that answers remain grounded in relevant knowledge.
- **Session Management**: Seamlessly manage user interactions, including access to session history, context updates, and session resets. Export session data for analytics and debugging.
- **Streaming Responses**: Enable real-time, incremental response generation for an enhanced user experience.
- **Source Attribution**: Responses include detailed citations, ensuring transparency and reliability by grounding answers in trustworthy sources.
---
## Installation
Install AuxKnow with a single command:
```bash
pip install auxknow
```
---
## Usage Instructions
To begin using AuxKnow, ensure you have the required API keys (`OPENAI_API_KEY` and `PERPLEXITY_API_KEY`) configured in a `.env` file in your project’s root directory.
Here is an example of how to get started:
```python
from auxknow import AuxKnow
# Initialize the Answer Engine
engine = AuxKnow()
# Ask a question
response = engine.ask("What is the capital of France?")
# Print the response and its citations
print(response.answer)
print(response.citations)
```
---
## Use Cases
AuxKnow is designed to cater to a wide range of scenarios, including:
- **Vertical AI Agents**: Build domain-specific AI agents tailored to industries such as healthcare, education, finance, or technology.
- **Advanced Q&A Systems**: Integrate robust answering capabilities into your applications, powered by state-of-the-art Sonar models.
- **Custom User Experiences**: Create personalized and immersive experiences with AuxKnow’s flexible configuration and session management features.
- **AI Infrastructure**: Enhance your AI or LLM platform with AuxKnow to deliver best-in-class answering capabilities to your users.
---
## Contributing
We welcome contributions from developers around the globe. To get started, please review the [Contributing Guidelines](https://the-hackers-playbook.gitbook.io/auxknow/contributions) and submit your ideas, bug reports, or pull requests. Together, we can make AuxKnow even better.
---
## License
AuxKnow is distributed under the AGPLv3 License. Refer to the [LICENSE](https://github.com/thehackersplaybook/auxknow/blob/main/LICENSE) file for full details. Please also read the [Terms of Use](https://the-hackers-playbook.gitbook.io/auxknow/terms-of-use) and [Trademark](https://github.com/thehackersplaybook/auxknow/blob/main/TRADEMARK.md).
---
## Quote
> "Knowledge is the foundation of progress." — The Hackers Playbook
Elevate your organization with AuxKnow and join us in redefining the future of AI-driven solutions.
Raw data
{
"_id": null,
"home_page": "https://github.com/thehackersplaybook/auxknow",
"name": "auxknow",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "Aditya Patange (AdiPat)",
"author_email": "contact.adityapatange@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/05/28/04e52deeca5f9c7f34d01e2e39452b0da4a9860a3e7cdd8e1967cc7b8bf9/auxknow-0.0.7.tar.gz",
"platform": null,
"description": "# AuxKnow \ud83d\udef8\n\n<p align=\"center\"><img src=\"https://i.ibb.co/8mX2Cqm/cover-art.png\" width=\"230\" alt=\"Khoj Logo\"></p>\n\n<div align=\"center\">\n\n[](#license)\n[](https://www.python.org/)\n[](#contributors)\n\n</div>\n\n<div align=\"center\">\n<b>Answer Engines, everywhere.</b>\n</div>\n\n<br />\n\n<div align=\"center\">\n\n[\ud83d\udca1 Docs](https://the-hackers-playbook.gitbook.io/auxknow)\n<span> \u2022 </span>\n[\ud83d\udd78\ufe0f Web](https://auxknow.io)\n<span> \u2022 </span>\n\n</div>\n\nAuxKnow is an advanced, state-of-the-art, fully customizable Answer Engine library, built to streamline the integration of intelligent answering capabilities into your applications. With AuxKnow, you can deploy feature-rich Answer Engines with minimal effort. For detailed guidance, refer to the [**Usage Instructions**](https://the-hackers-playbook.gitbook.io/auxknow/usage) section in the documentation.\n\n---\n\n## Background\n\nAt _The Hackers Playbook_, we are committed to building cutting-edge AI infrastructure and platforms grown out of Bharat (India). AuxKnow represents a significant milestone in our mission to deliver robust, developer-friendly tools for crafting AI-driven solutions. We encourage you to explore, innovate, and share your insights to help us improve and evolve. We look forward to your participation in our mission, since we are largely community driven and believe in Open Source culture.\n\nAuxKnow leverages the capabilities of [Perplexity\u2019s Sonar models](https://sonar.perplexity.ai/) to enable seamless integration of \"Answer Engine\" functionality. While Perplexity\u2019s models provide the foundational technology, AuxKnow bridges the gap by delivering a highly configurable and user-friendly library to accelerate application development.\n\n---\n\n## Key Features\n\n- **Fully Customizable**: Configure AuxKnow to align perfectly with your application\u2019s requirements. Its flexibility ensures it can adapt to various use cases, from simple Q&A to complex contextual reasoning.\n\n- **Dynamic Query Routing**: Automatically route user queries to the most appropriate model, ensuring optimal performance and accuracy.\n\n- **Intelligent Query Restructuring**: AuxKnow restructures user queries to improve response quality, delivering more accurate and relevant answers.\n\n- **Contextual Search**: AuxKnow can either leverage predefined contexts or autonomously build its own context to ensure that answers remain grounded in relevant knowledge.\n\n- **Session Management**: Seamlessly manage user interactions, including access to session history, context updates, and session resets. Export session data for analytics and debugging.\n\n- **Streaming Responses**: Enable real-time, incremental response generation for an enhanced user experience.\n\n- **Source Attribution**: Responses include detailed citations, ensuring transparency and reliability by grounding answers in trustworthy sources.\n\n---\n\n## Installation\n\nInstall AuxKnow with a single command:\n\n```bash\npip install auxknow\n```\n\n---\n\n## Usage Instructions\n\nTo begin using AuxKnow, ensure you have the required API keys (`OPENAI_API_KEY` and `PERPLEXITY_API_KEY`) configured in a `.env` file in your project\u2019s root directory.\n\nHere is an example of how to get started:\n\n```python\nfrom auxknow import AuxKnow\n\n# Initialize the Answer Engine\nengine = AuxKnow()\n\n# Ask a question\nresponse = engine.ask(\"What is the capital of France?\")\n\n# Print the response and its citations\nprint(response.answer)\nprint(response.citations)\n```\n\n---\n\n## Use Cases\n\nAuxKnow is designed to cater to a wide range of scenarios, including:\n\n- **Vertical AI Agents**: Build domain-specific AI agents tailored to industries such as healthcare, education, finance, or technology.\n\n- **Advanced Q&A Systems**: Integrate robust answering capabilities into your applications, powered by state-of-the-art Sonar models.\n\n- **Custom User Experiences**: Create personalized and immersive experiences with AuxKnow\u2019s flexible configuration and session management features.\n\n- **AI Infrastructure**: Enhance your AI or LLM platform with AuxKnow to deliver best-in-class answering capabilities to your users.\n\n---\n\n## Contributing\n\nWe welcome contributions from developers around the globe. To get started, please review the [Contributing Guidelines](https://the-hackers-playbook.gitbook.io/auxknow/contributions) and submit your ideas, bug reports, or pull requests. Together, we can make AuxKnow even better.\n\n---\n\n## License\n\nAuxKnow is distributed under the AGPLv3 License. Refer to the [LICENSE](https://github.com/thehackersplaybook/auxknow/blob/main/LICENSE) file for full details. Please also read the [Terms of Use](https://the-hackers-playbook.gitbook.io/auxknow/terms-of-use) and [Trademark](https://github.com/thehackersplaybook/auxknow/blob/main/TRADEMARK.md).\n\n---\n\n## Quote\n\n> \"Knowledge is the foundation of progress.\" \u2014 The Hackers Playbook\n\nElevate your organization with AuxKnow and join us in redefining the future of AI-driven solutions.\n",
"bugtrack_url": null,
"license": null,
"summary": "A simple, powerful and highly-configurable Answer Engine.",
"version": "0.0.7",
"project_urls": {
"Homepage": "https://github.com/thehackersplaybook/auxknow"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "686151aa5ef6a31ebe2b705371ec092d517edc0b0530710e56cc3f5b20dfef61",
"md5": "21fb816e10f1f95298b89f9276f1ca1d",
"sha256": "30936a729168104fb6765ad728d8c1b68f2c02e124e0e4f52ac65d2b98149aaf"
},
"downloads": -1,
"filename": "auxknow-0.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "21fb816e10f1f95298b89f9276f1ca1d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 23227,
"upload_time": "2025-02-08T09:13:24",
"upload_time_iso_8601": "2025-02-08T09:13:24.746225Z",
"url": "https://files.pythonhosted.org/packages/68/61/51aa5ef6a31ebe2b705371ec092d517edc0b0530710e56cc3f5b20dfef61/auxknow-0.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "052804e52deeca5f9c7f34d01e2e39452b0da4a9860a3e7cdd8e1967cc7b8bf9",
"md5": "cd6e42de9f3f06b6ac7a4a09e3d3a6a9",
"sha256": "e84c41e4e52bf1212effc8aefad215a4d30244e33103315ab43aea26936575a8"
},
"downloads": -1,
"filename": "auxknow-0.0.7.tar.gz",
"has_sig": false,
"md5_digest": "cd6e42de9f3f06b6ac7a4a09e3d3a6a9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 25724,
"upload_time": "2025-02-08T09:13:26",
"upload_time_iso_8601": "2025-02-08T09:13:26.963428Z",
"url": "https://files.pythonhosted.org/packages/05/28/04e52deeca5f9c7f34d01e2e39452b0da4a9860a3e7cdd8e1967cc7b8bf9/auxknow-0.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-08 09:13:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "thehackersplaybook",
"github_project": "auxknow",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "python-dotenv",
"specs": [
[
"==",
"1.0.1"
]
]
},
{
"name": "pydantic",
"specs": [
[
"==",
"2.10.4"
]
]
},
{
"name": "pydantic-settings",
"specs": [
[
"==",
"2.7.1"
]
]
},
{
"name": "pydantic_core",
"specs": [
[
"==",
"2.27.2"
]
]
},
{
"name": "firecrawl-py",
"specs": [
[
"==",
"1.8.0"
]
]
},
{
"name": "markdownify",
"specs": [
[
"==",
"0.14.1"
]
]
},
{
"name": "rich",
"specs": [
[
"==",
"13.9.4"
]
]
},
{
"name": "openai",
"specs": [
[
"==",
"1.59.9"
]
]
},
{
"name": "watchdog",
"specs": [
[
"==",
"6.0.0"
]
]
}
],
"lcname": "auxknow"
}
JSON
