| --- |
| language: |
| - en |
| license: other |
| license_name: cael-non-commercial |
| license_link: https://huggingface.co/vynly/CAEL-0.3.2/blob/main/LICENSE |
| pipeline_tag: text-generation |
| inference: false |
| tags: |
| - cael |
| - non-neural |
| - cellular-automata |
| - symbolic-reasoning |
| - retrieval |
| - web-search |
| --- |
| |
| # CAEL 0.3.2: internet search when it does not know |
|
|
| CAEL is a hybrid **non-neural** assistant. It combines counted language models, cellular automata, symbolic |
| reasoning, exact arithmetic, a bounded Python interpreter, local retrieval and hand-written knowledge. It uses |
| no neural network, transformer or external language model when it runs. This is a custom Python runtime, |
| **not a Transformers/AutoModel checkpoint**. |
|
|
| ## Download and run |
|
|
| 1. Get the source: [GitHub, Vovala14/CAEL](https://github.com/Vovala14/CAEL), or |
| [CAEL-0.3.2.zip](https://huggingface.co/vynly/CAEL-0.3.2/resolve/main/CAEL-0.3.2.zip) from this repository. |
| 2. Install and fetch the checksum-verified **553 MB** text-only bundle: |
|
|
| ```sh |
| python -m pip install -r requirements-unified.txt |
| python -m cael_unified --download |
| python -m cael_unified "Who wrote the opera The Magic Flute?" --mode chat |
| python -m cael_unified --ui # http://127.0.0.1:8765 |
| ``` |
|
|
| On Windows, `SETUP.bat` and then `RUN.bat` do the same. For an offline install, put |
| [cael-0.3.2.cael](https://huggingface.co/vynly/CAEL-0.3.2/resolve/main/cael-0.3.2.cael) in the source folder's |
| `models/` directory and run `python -m cael_unified --download`. |
|
|
| ## What's new in 0.3.2 |
|
|
| - **Web search fallback.** When a factual question has no local answer, CAEL searches the web, reads the pages |
| and quotes the sentence that answers it. |
| - Search order: Brave Search (set `BRAVE_API_KEY`; free monthly tier), a SearxNG instance |
| (`CAEL_SEARXNG_URL`), DuckDuckGo Instant Answers, then Wikipedia. When one fails or its free tier runs |
| out, the next one is used. |
| - Pages are read as clean text through Jina Reader, or by a direct fetch that only reaches public addresses. |
| - Every web answer links its source. "N different websites agree" appears only when two or more websites |
| give the same answer; otherwise CAEL says it is not sure and asks you to check the source. |
| - A sentence that only names the subject ("Scotland is a country ...") is not taken as the answer. |
| - "Write a Python script that searches the web for ..." gives the same search as a runnable script. |
| - Off with `CAEL_WEB_SEARCH=0`. With it on, your question is sent to the search services and Jina Reader. |
| - **More Wikidata facts:** currency, boiling and melting points, height, length, opening and release dates, |
| founding dates and creators. |
| - **Multiple choice:** a question with A–D options always goes to the multiple-choice engines. |
| - **Year answers** from Wikipedia must match every word of the event. |
| |
| ## Results (local, maintainer-run) |
|
|
| New questions written for this test (no benchmark items): |
|
|
| | | No internet | Wikipedia/Wikidata only | With web search | |
| |---|---:|---:|---:| |
| | Set 1 (44 questions) | 10 (23%) | 26 (59%) | **38 (86%)** | |
| | Set 2, written after the fixes (40) | 4 (10%) | 14 (35%) | **29 (73%)** | |
|
|
| How much to trust these numbers: |
| - **Set 1 was used to find the problems** fixed in this release, so treat 86% as a development score. |
| - **Set 2 was written after the fixes** and is the fairer estimate. |
| - Answers were graded by keyword; two set-1 answers counted correct were only partial. |
| - A web answer takes about 5–25 seconds and depends on what the search services return that day. |
|
|
| Web search does not help with theory-of-mind stories (Tiny Theory of Mind: about 24%). On NNAI-Bench, a |
| maintainer run of 0.3.1 scored 68.11%, marked **test-adapted** on the |
| [leaderboard](https://huggingface.co/spaces/vynly/non-neural-ai-leaderboard). |
|
|
| ## Licence and data |
|
|
| - **CAEL Non-Commercial License** ([LICENSE](LICENSE)): free for personal and research use. Commercial use needs |
| a separate written licence from the copyright holder (Vovala14). |
| - CAEL only uses third-party material that allows commercial use. Components derived from CC BY-SA sources |
| (Wikipedia, Stack Exchange, Dolly, Wikibooks, Wikivoyage) remain under CC BY-SA. See [NOTICE.md](NOTICE.md). |
| - Web pages quoted in answers belong to their websites; CAEL links each one. |
|
|
| ## Limits |
|
|
| - Web answers are only as good as the pages found; CAEL does not check them beyond agreement between websites. |
| - The facts table is finite, and supported reasoning and programming forms are narrow. |
| - **No picture generation in 0.3.2.** |
|
|
