ChiKen!
Project description
ChiKen
ChiKen is your private, AI-powered research assistant that transforms your Zotero library into an interactive knowledge base.
✨ Features
ChiKen connects your Zotero library to LLM clients like Claude Desktop through RAG and MCP. Just make a few clicks, your AI clients are ready to search over your documents.
ChiKen chat interface offers three agents to interact with your research: Chat for conversational Q&A with your documents, Search for searching papers online, and Deep Research for comprehensive multi-source investigations that combine your personal library with web search to generate detailed research reports.
https://github.com/user-attachments/assets/983e3e05-6f37-46ba-a19e-69f7207c4e83
💫 Quick Start
Download and install ChiKen from Releases for your platform. PDF and plain text work out of the box; other formats require Pandoc 2+. Zotero 7+ is also required for enabling local API.
We recommend Ollama for local LLMs—easy setup for chat and embeddings. Works well with ollama/gemma3:27b. For now this is the only recommended and tested model. You can then expose your knowledge bases to advanced LLM clients like Claude Desktop through the built-in MCP server.
All data stays local. API keys are stored in your OS keychain:❓You may see prompts asking for keyring access; knowledge bases live on your disk.
For more detailed instructions, see:
🗺️ What's Next
ChiKen continues to evolve with enhanced document parsing (both lightweight and powerful options for literature), expanded MCP tools for deeper knowledge interaction, and architectural improvements including a planned shift to PyTauri for better performance.
🌱 Contributing
We’re excited to welcome contributions!
A dedicated section with contribution guidelines and instructions is coming soon.
If you have feature requests, bug reports, or ideas, feel free to open an issue or discussion in the meantime.
💬 The Name
In the world of research, Zotero helps us to see and collect knowledge. The name comes from the Albanian word zotëroj, meaning "to master." But how do we turn that collection into true understanding?
This is the question that inspired ChiKen (知見). The name comes from jñāna-darśana (ज्ञानदर्शन), a Buddhist term for "knowledge and insight." It represents the flash of understanding that comes from deep engagement with information.
ChiKen is designed to complete the journey Zotero begins: the mastery of information (Zotero) and the spark of insight (ChiKen). We want to help you not just collect knowledge, but to connect with it, question it, and ultimately, to see it in a new light.
License
The code is licensed under the MIT License. The logo is licensed under CC BY 4.0.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file iflow_mcp_yuanjua_chiken-0.2.4.tar.gz.
File metadata
- Download URL: iflow_mcp_yuanjua_chiken-0.2.4.tar.gz
- Upload date:
- Size: 145.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ac3ef32da58e21ecc60879b603665ab36c1b39db8f2b71aed78cd88c497a97a1
|
|
| MD5 |
3f70841e5cc37f84d668aa25caf9db03
|
|
| BLAKE2b-256 |
07c2e6bc3c00abef1a85ced4c870e5f35b7f6653e8da6da356d936e6de743766
|
File details
Details for the file iflow_mcp_yuanjua_chiken-0.2.4-py3-none-any.whl.
File metadata
- Download URL: iflow_mcp_yuanjua_chiken-0.2.4-py3-none-any.whl
- Upload date:
- Size: 174.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df9137e85f82c714f24926bb17464d300c6c09d867b81d7a8a99bae1a07a6a52
|
|
| MD5 |
25d211fdb94c8664a2a02740207624d2
|
|
| BLAKE2b-256 |
a991470270b28f22d272c0347518e5825c4b94b4866a44aee20caebc25c46a15
|
