commit 4fb7a627a3f93e2baa8911dc6156487e0b510a1c Author: ModelHub XC Date: Wed Oct 21 15:46:16 2026 +0800 初始化项目，由ModelHub XC社区提供模型 Model: gabriellarson/Lucy-GGUF Source: Original Platform diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..65d0550 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,61 @@ +*.7z filter=lfs diff=lfs merge=lfs -text +*.arrow filter=lfs diff=lfs merge=lfs -text +*.bin filter=lfs diff=lfs merge=lfs -text +*.bz2 filter=lfs diff=lfs merge=lfs -text +*.ckpt filter=lfs diff=lfs merge=lfs -text +*.ftz filter=lfs diff=lfs merge=lfs -text +*.gz filter=lfs diff=lfs merge=lfs -text +*.h5 filter=lfs diff=lfs merge=lfs -text +*.joblib filter=lfs diff=lfs merge=lfs -text +*.lfs.* filter=lfs diff=lfs merge=lfs -text +*.mlmodel filter=lfs diff=lfs merge=lfs -text +*.model filter=lfs diff=lfs merge=lfs -text +*.msgpack filter=lfs diff=lfs merge=lfs -text +*.npy filter=lfs diff=lfs merge=lfs -text +*.npz filter=lfs diff=lfs merge=lfs -text +*.onnx filter=lfs diff=lfs merge=lfs -text +*.ot filter=lfs diff=lfs merge=lfs -text +*.parquet filter=lfs diff=lfs merge=lfs -text +*.pb filter=lfs diff=lfs merge=lfs -text +*.pickle filter=lfs diff=lfs merge=lfs -text +*.pkl filter=lfs diff=lfs merge=lfs -text +*.pt filter=lfs diff=lfs merge=lfs -text +*.pth filter=lfs diff=lfs merge=lfs -text +*.rar filter=lfs diff=lfs merge=lfs -text +*.safetensors filter=lfs diff=lfs merge=lfs -text +saved_model/**/* filter=lfs diff=lfs merge=lfs -text +*.tar.* filter=lfs diff=lfs merge=lfs -text +*.tar filter=lfs diff=lfs merge=lfs -text +*.tflite filter=lfs diff=lfs merge=lfs -text +*.tgz filter=lfs diff=lfs merge=lfs -text +*.wasm filter=lfs diff=lfs merge=lfs -text +*.xz filter=lfs diff=lfs merge=lfs -text +*.zip filter=lfs diff=lfs merge=lfs -text +*.zst filter=lfs diff=lfs merge=lfs -text +*tfevents* filter=lfs diff=lfs merge=lfs -text +Lucy-IQ1_S.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-IQ2_M.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-IQ2_S.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-IQ2_XS.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-IQ2_XXS.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q4_0.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q5_0.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-IQ1_M.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-IQ3_M.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-IQ3_S.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-IQ3_XS.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-IQ3_XXS.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q2_K.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q2_K_S.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q3_K_M.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q3_K_S.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-1.7B-F16.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-IQ4_NL.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-IQ4_XS.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q3_K_L.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q4_K_M.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q4_K_S.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q5_K_M.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q5_K_S.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q6_K.gguf filter=lfs diff=lfs merge=lfs -text +Lucy-Q8_0.gguf filter=lfs diff=lfs merge=lfs -text diff --git a/Lucy-1.7B-F16.gguf b/Lucy-1.7B-F16.gguf new file mode 100644 index 0000000..5e19186 --- /dev/null +++ b/Lucy-1.7B-F16.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:4865da36002f3ebaa491a7dd5eb3afe08659046b47147607fec5e626e95743a1 +size 3447349248 diff --git a/Lucy-IQ1_M.gguf b/Lucy-IQ1_M.gguf new file mode 100644 index 0000000..d14df91 --- /dev/null +++ b/Lucy-IQ1_M.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a87c8cd02a9319531584150ad6d4513228fc71039e826d188241220b4168e898 +size 543793376 diff --git a/Lucy-IQ1_S.gguf b/Lucy-IQ1_S.gguf new file mode 100644 index 0000000..49c704a --- /dev/null +++ b/Lucy-IQ1_S.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:503f50abb438a4142e7c098bd2137b32ac8b5ed35e2689769601229ad1fbfed0 +size 515776736 diff --git a/Lucy-IQ2_M.gguf b/Lucy-IQ2_M.gguf new file mode 100644 index 0000000..df67c6d --- /dev/null +++ b/Lucy-IQ2_M.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a9caa7ebc6436306fd8c70b433c88a3410c337e5c454bca30d339155ae8614de +size 695181536 diff --git a/Lucy-IQ2_S.gguf b/Lucy-IQ2_S.gguf new file mode 100644 index 0000000..4c0addd --- /dev/null +++ b/Lucy-IQ2_S.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:149548f862b347b4daeb51cdd768ccda4868720954a50400381344f7ab31af2f +size 657826016 diff --git a/Lucy-IQ2_XS.gguf b/Lucy-IQ2_XS.gguf new file mode 100644 index 0000000..d4b27d8 --- /dev/null +++ b/Lucy-IQ2_XS.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:cc9c533a6c3907ddec6262604ad92697e38bbe2efa096eb830be3747e9fb2241 +size 631513312 diff --git a/Lucy-IQ2_XXS.gguf b/Lucy-IQ2_XXS.gguf new file mode 100644 index 0000000..18c8d00 --- /dev/null +++ b/Lucy-IQ2_XXS.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:c2cc663d71187dd7de88156bf43325efe8ca82ee2a306d428ba4a0e891a896d3 +size 590487776 diff --git a/Lucy-IQ3_M.gguf b/Lucy-IQ3_M.gguf new file mode 100644 index 0000000..4b71e13 --- /dev/null +++ b/Lucy-IQ3_M.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:7185ac8ddb50718350623335599d4346df1ab47acaa1771ef36494f139e27ca5 +size 895662304 diff --git a/Lucy-IQ3_S.gguf b/Lucy-IQ3_S.gguf new file mode 100644 index 0000000..10303ab --- /dev/null +++ b/Lucy-IQ3_S.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:07beb00657432779a0d06078a4a768f7c058fe78bf3f14c1e8de3b21142b50f9 +size 867252448 diff --git a/Lucy-IQ3_XS.gguf b/Lucy-IQ3_XS.gguf new file mode 100644 index 0000000..0c542f1 --- /dev/null +++ b/Lucy-IQ3_XS.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:af847f61ea22a3855ba4ed06482360f63acadfe23bbabf115682993debf41601 +size 834222304 diff --git a/Lucy-IQ3_XXS.gguf b/Lucy-IQ3_XXS.gguf new file mode 100644 index 0000000..4070b43 --- /dev/null +++ b/Lucy-IQ3_XXS.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:87c6e6e172b7251e2df413b3004231d475c6f4ef9bea9d473c20383f3bec2216 +size 754360544 diff --git a/Lucy-IQ4_NL.gguf b/Lucy-IQ4_NL.gguf new file mode 100644 index 0000000..44ee659 --- /dev/null +++ b/Lucy-IQ4_NL.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:04752301290035193f1ca3c321c1a43ec9a171ea6077c659915be7ec0d01da66 +size 1054423264 diff --git a/Lucy-IQ4_XS.gguf b/Lucy-IQ4_XS.gguf new file mode 100644 index 0000000..a0290a7 --- /dev/null +++ b/Lucy-IQ4_XS.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0041200a6d8b993dbdf10f0c231c66f78a8bf5720b560289253c36e76ef7b606 +size 1010383072 diff --git a/Lucy-Q2_K.gguf b/Lucy-Q2_K.gguf new file mode 100644 index 0000000..4d0f051 --- /dev/null +++ b/Lucy-Q2_K.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:99c5ec66d2ee1821d52e033e7f6d2d0f9c90ca868f870fc906796fcb0733ab25 +size 777795808 diff --git a/Lucy-Q2_K_S.gguf b/Lucy-Q2_K_S.gguf new file mode 100644 index 0000000..04b0d0f --- /dev/null +++ b/Lucy-Q2_K_S.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:105c4fe1b9659734f637b9998f2f94ce8d84b1178cc1b98fb86d33817f94b92c +size 732969184 diff --git a/Lucy-Q3_K_L.gguf b/Lucy-Q3_K_L.gguf new file mode 100644 index 0000000..d16e071 --- /dev/null +++ b/Lucy-Q3_K_L.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:122d48dedf0b0a6aa21b57ee07597ef49a4b5fc9f5b7f4727a668e6da6ab3535 +size 1003501792 diff --git a/Lucy-Q3_K_M.gguf b/Lucy-Q3_K_M.gguf new file mode 100644 index 0000000..bbcf71a --- /dev/null +++ b/Lucy-Q3_K_M.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:5f1a61f1173ad4e2ca880c7fa291b84fe81e808c65bb23937d7590027ce2158c +size 939538656 diff --git a/Lucy-Q3_K_S.gguf b/Lucy-Q3_K_S.gguf new file mode 100644 index 0000000..917ebd8 --- /dev/null +++ b/Lucy-Q3_K_S.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:f717ca9fe44dc905b29d2918dd85dc69ddc33345f27fc40fe47d19862fef0e39 +size 867252448 diff --git a/Lucy-Q4_0.gguf b/Lucy-Q4_0.gguf new file mode 100644 index 0000000..36347bb --- /dev/null +++ b/Lucy-Q4_0.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:dc721ecfcd0a70307ca2cb6b32b3cffe8fe5b24a32dd3948cb7b288e6fb5bb36 +size 1056782560 diff --git a/Lucy-Q4_K_M.gguf b/Lucy-Q4_K_M.gguf new file mode 100644 index 0000000..067effe --- /dev/null +++ b/Lucy-Q4_K_M.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:cb0e7b67d1d587824fb0e06fcb9bfccb09b7eca13a2a0743867dd70c674a32e3 +size 1107409120 diff --git a/Lucy-Q4_K_S.gguf b/Lucy-Q4_K_S.gguf new file mode 100644 index 0000000..4f1d66e --- /dev/null +++ b/Lucy-Q4_K_S.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:f3f2073d6508d6ca2729c6634802a562eab575854343a77c6296db234508e03b +size 1060190432 diff --git a/Lucy-Q5_0.gguf b/Lucy-Q5_0.gguf new file mode 100644 index 0000000..adb77d0 --- /dev/null +++ b/Lucy-Q5_0.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:2d12e049f00d2869fc117a0b7fbe09d0d1ff26f71df64dadaedcdd54b035dd83 +size 1232943328 diff --git a/Lucy-Q5_K_M.gguf b/Lucy-Q5_K_M.gguf new file mode 100644 index 0000000..9d49d59 --- /dev/null +++ b/Lucy-Q5_K_M.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:96c39d6dadf0ffcc3f7c7e008f0d9bc9a00608545059d98b1c4a3b80f0356725 +size 1257879776 diff --git a/Lucy-Q5_K_S.gguf b/Lucy-Q5_K_S.gguf new file mode 100644 index 0000000..c7d930c --- /dev/null +++ b/Lucy-Q5_K_S.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:50a840897ba05268c1c18c3a48d18880719c63a48b4438716adfd40ad1c0130d +size 1230584032 diff --git a/Lucy-Q6_K.gguf b/Lucy-Q6_K.gguf new file mode 100644 index 0000000..9947053 --- /dev/null +++ b/Lucy-Q6_K.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:139ce7614028f0c0815e81e881d4fa3c7d47abfe923c4b91918185e9acdaf077 +size 1417754848 diff --git a/Lucy-Q8_0.gguf b/Lucy-Q8_0.gguf new file mode 100644 index 0000000..4f84d47 --- /dev/null +++ b/Lucy-Q8_0.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:05a9c7a2c1f169be51516c115cf31394bf1a2c68b78dfe4fdc96b44fea8fe615 +size 1834426592 diff --git a/README.md b/README.md new file mode 100644 index 0000000..d85babb --- /dev/null +++ b/README.md @@ -0,0 +1,78 @@ +--- +license: apache-2.0 +language: +- en +base_model: +- Menlo/Lucy +pipeline_tag: text-generation +library_name: transformers +--- +# Lucy: Edgerunning Agentic Web Search on Mobile with a 1.7B model. + +[![GitHub](https://img.shields.io/badge/GitHub-Repository-blue?logo=github)](https://github.com/menloresearch/deep-research) +[![License](https://img.shields.io/badge/License-Apache%202.0-yellow)](https://opensource.org/licenses/Apache-2.0) + +
+ Lucy-128k +
+ +**Authors:** [Alan Dao](https://scholar.google.com/citations?user=eGWws2UAAAAJ&hl=en), [Bach Vu Dinh](https://scholar.google.com/citations?user=7Lr6hdoAAAAJ&hl=vi), [Alex Nguyen](https://github.com/nguyenhoangthuan99) + + +![image/gif](lucy_demo.gif) + + +## Overview + +Lucy is a compact but capable 1.7B model focused on agentic web search and lightweight browsing. Built on [Qwen3-1.7B](https://huggingface.co/Qwen/Qwen3-1.7B), Lucy inherits deep research capabilities from larger models while being optimized to run efficiently on mobile devices, even with CPU-only configurations. + +We achieved this through machine-generated task vectors that optimize thinking processes, smooth reward functions across multiple categories, and pure reinforcement learning without any supervised fine-tuning. + +## What Lucy Excels At + +- **🔍 Strong Agentic Search**: Powered by MCP-enabled tools (e.g., Serper with Google Search) +- **🌐 Basic Browsing Capabilities**: Through Crawl4AI (MCP server to be released), Serper,... +- **📱 Mobile-Optimized**: Lightweight enough to run on CPU or mobile devices with decent speed +- **🎯 Focused Reasoning**: Machine-generated task vectors optimize thinking processes for search tasks + +## Evaluation +Following the same MCP benchmark methodology used for [Jan-Nano](https://huggingface.co/Menlo/Jan-nano) and [Jan-Nano-128k](https://huggingface.co/Menlo/Jan-nano-128k), Lucy demonstrates impressive performance despite being only a 1.7B model, achieving higher accuracy than DeepSeek-v3 on [SimpleQA](https://openai.com/index/introducing-simpleqa/). + +![image/png](https://cdn-uploads.huggingface.co/production/uploads/65713d70f56f9538679e5a56/lG2FqLCWXq1N8lh7wlJgW.png) + +## 🖥️ How to Run Locally + +Lucy can be deployed using various methods including vLLM, llama.cpp, or through local applications like Jan, LMStudio, and other compatible inference engines. The model supports integration with search APIs and web browsing tools through the MCP. + +### Deployment + +Deploy using VLLM: +```bash +vllm serve Menlo/Lucy-128k \ + --host 0.0.0.0 \ + --port 1234 \ + --enable-auto-tool-choice \ + --tool-call-parser hermes +``` + +Or `llama-server` from `llama.cpp`: +```bash +llama-server ... +``` + +### Recommended Sampling Parameters + +```yaml +Temperature: 0.7 +Top-p: 0.9 +Top-k: 20 +Min-p: 0.0 +``` + +## 🤝 Community & Support + +- **Discussions**: [HuggingFace Community](https://huggingface.co/Menlo/Lucy-128k/discussions) + +## 📄 Citation + +**Paper (coming soon)**: *Lucy: edgerunning agentic web search on mobile with machine generated task vectors.* \ No newline at end of file