knowlin 0.38.31__tar.gz

knowlin-0.38.31/LICENSE

@@ -0,0 +1,202 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this
+      License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 The Knowlin Authors (Knowlin, Python-Paket duckpilot)
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

knowlin-0.38.31/NOTICE

@@ -0,0 +1,77 @@
+Knowlin / duckpilot
+Copyright 2026 The Knowlin Authors
+
+Ein freies, nicht-kommerzielles Hobbyprojekt für kleine Roboter – die Microduck und Reachy Mini von Pollen Robotics
+und Hugging Face sowie die Open Duck Mini v2 von Antoine Pirrone und Community. Knowlin und duckpilot stehen in keiner
+Verbindung zu Pollen Robotics, Hugging Face oder dem Open-Duck-Projekt und werden von ihnen weder unterstützt noch
+geprüft. „Microduck“ und „Reachy Mini“ sind Namen von Pollen Robotics.
+
+Der Quelltext von duckpilot steht unter der Apache License 2.0 (siehe LICENSE).
+Entwickelt mit Claude (Anthropic).
+
+------------------------------------------------------------------------------------------------------
+Nicht enthalten, sondern zur Laufzeit von der Originalquelle geladen
+------------------------------------------------------------------------------------------------------
+
+Microduck-Robotermodell (3D-Teile und MuJoCo-Modell)
+  Quelle:  https://github.com/pollen-robotics/microduck_rl (fester Stand, siehe duckpilot/modell/quellen.json)
+  Meshes (*.stl): © Pollen Robotics, Creative Commons BY-NC-SA 4.0
+                  https://creativecommons.org/licenses/by-nc-sa/4.0/
+  MJCF-Beschreibung (*.xml): © Pollen Robotics, Apache License 2.0
+  duckpilot lädt die Dateien beim ersten Start auf den PC des Nutzers und bereitet sie dort auf
+  (3D-Ansicht: Normalen und Quantisierung; Physik: nur Kollisionskörper). Die aufbereiteten Dateien
+  bleiben auf diesem PC und stehen wie das Original unter CC BY-NC-SA 4.0 – nur nicht-kommerziell.
+
+Policies für den Physik-Simulator
+  Quelle:  https://huggingface.co/pollen-robotics/microduck-policies – geladen auf Knopfdruck.
+
+Reachy-Mini-Robotermodell (3D-Teile, Kinematik)
+  Quelle:  https://github.com/pollen-robotics/reachy_mini (fester Stand, siehe duckpilot/modell/reachy_quellen.json)
+  Hardware-Dateien: © Pollen Robotics, Creative Commons BY-NC-SA 4.0; Software: Apache License 2.0.
+  Auf Knopfdruck geladen und auf dem PC des Nutzers aufbereitet; die aufbereitete Datei bleibt auf diesem PC.
+
+Reachy-Mini-Emotionen und -Tänze
+  Quelle:  Pollens Datensätze reachy-mini-emotions-library und reachy-mini-dances-library auf Hugging Face –
+  auf Knopfdruck geladen (fester Stand).
+
+Handerkennung für die Kamera-Spiele: MediaPipe Hand Landmarker (seit 0.38.14)
+  Laufzeit: @mediapipe/tasks-vision 0.10.21 (https://www.npmjs.com/package/@mediapipe/tasks-vision),
+            Modell: hand_landmarker.task, Stand float16/1 (https://storage.googleapis.com/mediapipe-models/)
+  Copyright Google LLC – Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).
+  Fester Stand und Prüfsummen in duckpilot/modell/hand_quellen.json. Erst auf Klick („Handerkennung laden“)
+  auf den PC des Nutzers geladen, unverändert im Datenordner abgelegt und vom eigenen Server an den Browser
+  ausgeliefert; ausgewertet wird nur im Browser.
+
+------------------------------------------------------------------------------------------------------
+Enthalten: Bearbeitungen von Werken Dritter
+------------------------------------------------------------------------------------------------------
+
+Microduck-Emotionen (duckpilot/motion/pollen_emotions.json, duckpilot/server/static/sounds/emotions/)
+  Nach https://github.com/pollen-robotics/microduck_emotions – Copyright Pollen Robotics, Apache License 2.0.
+  Geändert: Keyframes in duckpilots Choreografie-Format übersetzt, Töne nach Opus umgewandelt
+  (tools/import_emotions.py).
+
+Entenstimme und Gesten-Laute (duckpilot/server/static/sounds/voice/, sounds/gesten/)
+  Gerendert mit dem Stimm-Synthesizer aus https://github.com/pollen-robotics/microduck_emotions (quack.py)
+  und nach den Rezepten aus https://github.com/pollen-robotics/microduck (sounds/src/voices.rs) –
+  Copyright Pollen Robotics, Apache License 2.0. Geändert: Varianten, Längen und Stimmfärbungen
+  (tools/render_voice.py, tools/render_gestures.py).
+
+Robotersteuerung (duckpilot/backends/robotd.py, duckpilot/physics/*)
+  Schnittstellen, Beobachtungsvektor, Filter- und Glättungswerte nach https://github.com/pollen-robotics/microduck
+  und https://github.com/pollen-robotics/microduck_rl – Copyright Pollen Robotics, Apache License 2.0.
+
+Open Duck Mini v2 – 3D-Modell (duckpilot/server/static/model/open_duck_mini.dpm)
+  Nach https://github.com/apirrone/Open_Duck_Mini (Ordner mini_bdx/robots/open_duck_mini_v2, fester Stand, siehe
+  duckpilot/modell/open_duck.py) – Copyright Antoine Pirrone und Mitwirkende, Apache License 2.0.
+  Geändert: Meshes für die 3D-Ansicht aufbereitet (Normalen, Quantisierung), Elektronik ausgeblendet, dunkle Gläser in
+  die Kopföffnungen gesetzt, Gelenkwinkel auf duckpilots Simulator umgerechnet (tools/bake_open_duck.py).
+
+three.js (duckpilot/server/static/vendor/three*.js, BufferGeometryUtils.js)
+  Copyright 2010-2024 three.js authors – MIT License (vendor/THREE-LICENSE).
+
+IBM Plex Sans und IBM Plex Mono (duckpilot/server/static/vendor/plex/)
+  Copyright IBM Corp. – SIL Open Font License 1.1 (vendor/plex/LICENSE-OFL.txt).
+
+IBM Carbon Design System (Gestaltung, Theme Gray 90; nachgebaut in server/static/ds/)
+  Copyright IBM Corp. – Apache License 2.0.

knowlin-0.38.31/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.4
+Name: knowlin
+Version: 0.38.31
+Summary: Knowlin – ein Kopf, viele Körper: Microduck, Reachy Mini und Open Duck Mini am PC simulieren, mit Claude und Sprache steuern und auf den echten Roboter umschalten.
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/knowlin-ai/knowlin
+Project-URL: Issues, https://github.com/knowlin-ai/knowlin/issues
+Project-URL: Changelog, https://github.com/knowlin-ai/knowlin/blob/main/CHANGELOG.md
+Keywords: robotics,microduck,reachy-mini,open-duck-mini,claude,simulator,voice-assistant
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: anthropic>=0.40
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn[standard]>=0.29
+Requires-Dist: keyring>=24
+Requires-Dist: numpy>=1.24
+Requires-Dist: fast-simplification>=0.1.12; platform_system != "Linux" or platform_machine != "x86_64" or python_version < "3.14"
+Requires-Dist: zeroconf>=0.130
+Provides-Extra: whisper
+Requires-Dist: faster-whisper>=1.0; extra == "whisper"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: httpx>=0.27; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="docs/bilder/banner.png" alt="Knowlin – one mind, many bodies: the start page with Knowlin's neural network and the three embodiments" width="100%">
+</p>
+
+<h1 align="center">Knowlin</h1>
+
+<p align="center">
+  <strong>One mind, many bodies.</strong><br>
+  A self-learning companion that embodies small robots –<br>
+  virtual in the simulator today, then physically in your real surroundings.
+</p>
+
+<p align="center">
+  <a href="https://github.com/knowlin-ai/knowlin/actions/workflows/pruefen.yml"><img alt="Checks" src="https://github.com/knowlin-ai/knowlin/actions/workflows/pruefen.yml/badge.svg"></a>
+  <a href="LICENSE"><img alt="License: Apache-2.0" src="docs/bilder/abzeichen/license.svg"></a>
+  <img alt="Python 3.11 to 3.13" src="docs/bilder/abzeichen/python.svg">
+  <a href="docs/barrierefreiheit.md"><img alt="Accessibility goal: WCAG 2.2 AA" src="docs/bilder/abzeichen/wcag-en.svg"></a>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick start</a> ·
+  <a href="#what-knowlin-does">Features</a> ·
+  <a href="#bodies-and-modules">Bodies</a> ·
+  <a href="#safety-and-privacy">Safety</a> ·
+  <a href="#contributing">Contributing</a> ·
+  <a href="README.md">Deutsch</a>
+</p>
+
+> [!NOTE]
+> **Free, non-commercial hobby project.** Knowlin is not affiliated with Pollen Robotics, Hugging Face or the Open Duck
+> project and is neither endorsed nor reviewed by them. Pollen's robot models are not included: Knowlin downloads them
+> from the original source and prepares them on your PC – see [Legal and sources](#legal-and-sources).
+
+> **Just want a look?** Pictures and an overview at [knowlin.de](https://knowlin.de).
+
+## The idea
+
+**Knowlin** is one shared mind for several robots. It knows your surroundings, your everyday life and the things you
+have experienced together – and takes on a body depending on the task: the walking **Microduck**, the self-built
+**Open Duck Mini** or the desk robot **Reachy Mini**. Each **embodiment** has its own name, voice and character; the
+knowledge is shared.
+
+Without a body, Knowlin is calm and matter-of-fact. When something needs movement – walking, dancing, showing you
+something – it suggests the right robot and asks whether to use it.
+
+<p align="center">
+  <picture>
+    <!-- with “reduce motion” switched on, a still image instead of the animation -->
+    <source media="(prefers-reduced-motion: reduce)" srcset="docs/bilder/startseite-en.png">
+    <img src="docs/bilder/knowlin.gif" alt="Animation: the start page with Knowlin's softly moving neural network, a short conversation (“Who are you?”), then Knowlin wakes Reachy" width="100%">
+  </picture>
+</p>
+
+## What Knowlin does
+
+<table>
+  <tr>
+    <td width="50%" valign="top">
+      <img src="docs/bilder/cockpit-en.png" alt="Cockpit with the Microduck in the simulator living room and the conversation next to it"><br>
+      <strong>Voice and Claude</strong><br>
+      Free sentences, wake word or push-to-talk: Claude understands, plans sequences and rehearses new moves invisibly in
+      the physics first. Simple commands also work without AI – or with your own model on your graphics card.
+    </td>
+    <td width="50%" valign="top">
+      <img src="docs/bilder/synapsen-en.png" alt="Brain activity: the experience network as a spatial network with glowing connections"><br>
+      <strong>Memory and experience network</strong><br>
+      Knowlin remembers places, things, tricks and what you tell it – and where it learned it: without a body or in which
+      embodiment, in the simulator or on the real robot. Everything stays on your PC.
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" valign="top">
+      <img src="docs/bilder/charakter-en.png" alt="Character field: Knowlin's basic character between calm and lively, serious and playful, with the embodiments as points"><br>
+      <strong>One character, many variations</strong><br>
+      Pick Knowlin's basic character on a field between calm and lively, serious and playful. Each embodiment has its
+      own variation and the traits of its form – from beak clattering to antenna play.
+    </td>
+    <td width="50%" valign="top">
+      <img src="docs/bilder/reachy-en.png" alt="Reachy Mini in the simulator"><br>
+      <strong>Dancing, games, everyday life</strong><br>
+      Dances on the beat, Pollen's emotions, camera games with Reachy (“Red light, green light”), timers, reminders and
+      appointments – and a phone remote on your own Wi-Fi.
+    </td>
+  </tr>
+</table>
+
+**Also:** its own voice running locally (Piper, or a sound designed with Qwen3-TTS) · speech recognition and chatting ·
+simulator with a living room, things to play with and optional real physics · tricks from the Hugging Face Hub, courses
+and training (free on your PC or on Kaggle) · **Knowlets**: share character, tricks and dances as a package – data only,
+never knowledge about people · interface in English and German.
+
+## Bodies and modules
+
+The modules have code names by kind of body: **duckpilot** for the walking ducks, **deskpilot** for stationary desk
+robots. Every body shows only what it can do – what it lacks (legs, depth sensor, beak …) simply isn't there.
+
+| Embodiment | Body | Module | Maker | In the simulator | Real robot |
+|---|---|---|---|---|---|
+| **Quacki** | Microduck | duckpilot | Pollen Robotics and Hugging Face | simple and with real physics | via `robotd` (Pollen's daemon) |
+| **Odi** | Open Duck Mini v2 | duckpilot | Antoine Pirrone and community | open model: walking, head, antennas, avoids obstacles with its camera | planned |
+| **Reachy** | Reachy Mini | deskpilot | Pollen Robotics and Hugging Face | Pollen's model, emotions, dances, games | via Pollen's daemon (untested) |
+
+```mermaid
+flowchart LR
+  Human(["You – voice, text, phone"]) --> Mind
+  subgraph Mind["Knowlin – one mind"]
+    direction TB
+    Brain["Brain<br/>Claude · own model · simple commands"]
+    Memory["Memory and experience network<br/>surroundings · everyday life · experiences"]
+    Character["Basic character and voice"]
+  end
+  Mind --> Safety{{"Safety<br/>emergency stop always wins"}}
+  Safety --> D["duckpilot<br/>Microduck · Open Duck"]
+  Safety --> R["deskpilot<br/>Reachy Mini"]
+  D --> Sim[("Simulator<br/>with physics")]
+  R --> Sim
+  D -. "switchable" .-> Real[("Real robot")]
+  R -. "switchable" .-> Real
+```
+
+## Quick start
+
+**Windows – with the installer (recommended)**
+
+1. [**Download Knowlin-Setup**](https://github.com/knowlin-ai/knowlin/releases/latest) – under “Assets”, the file
+   `Knowlin-Setup-….exe`.
+2. Double-click it. Python is included, no administrator rights needed. If Windows says “Windows protected your PC”,
+   click **More info → Run anyway** – the installer isn't signed yet.
+3. Start Knowlin from **Knowlin** in the start menu or on the desktop. The **First steps** assistant walks you through
+   language, body, brain and the safety rules. For Claude, paste your Anthropic API key (platform.claude.com → Settings
+   → API keys). It is stored in the operating system's vault, never in a file. Without a key, simple commands work
+   (“walk forward”, “dance”, “stop”).
+
+Updates: just install the new installer on top – memory and settings stay. Uninstall via Windows Settings → Apps.
+
+**With Python (Windows, macOS, Linux):** `pipx install knowlin`, then `knowlin --app` (own window) or `knowlin`
+(console and browser). On Windows, `knowlin --verknuepfung` adds the start menu and desktop entries. Update with
+`pipx upgrade knowlin`.
+
+**From source:** clone the repository, then on Windows double-click `start.bat`. The first time it creates a Python
+environment under `%LOCALAPPDATA%\duckpilot` (not in your OneDrive folder) and installs the packages and shortcuts.
+
+On macOS and Linux from source: `./start.sh` (console and browser) or `./start.sh --app` (own window with Chrome/Edge).
+Needs Python 3.11 or newer; on Debian/Ubuntu also `python3-venv`. The browser's speech recognition only exists in
+Chrome and Edge – on Linux, use local recognition instead (Settings → Conversation →
+Speech recognition “Local”, after a one-time `.venv/bin/pip install faster-whisper`).
+
+<details>
+<summary>More about starting: window, console, updates</summary>
+
+- **The window** is Microsoft Edge in app mode with its own profile under `%LOCALAPPDATA%\duckpilot\fenster` – an
+  embedded window couldn't use the browser's speech recognition. Without Edge, Knowlin uses Chrome, otherwise your
+  default browser.
+- **Console instead of window:** `start.bat` with arguments, e.g. `start.bat --backend robotd --robot tcp:127.0.0.1:7900`.
+  Logs in window mode are in `%LOCALAPPDATA%\duckpilot\duckpilot.log`.
+- **Updates from source:** run `start.bat` again – it only installs what changed. Closing the window ends Knowlin after a few seconds.
+- **For developers:** `pip install -e ".[dev]"`, then `python -m duckpilot` (the Python package is called `duckpilot` for
+  historical reasons).
+
+</details>
+
+## Safety and privacy
+
+| | |
+|---|---|
+| **Emergency stop wins** | <kbd>Esc</kbd>, the red button or “Stop” halt everything at once – with or without AI. Afterwards nothing stands up or sits down by itself for at least two minutes (can only be made longer). |
+| **Keys** | only in the operating system's vault, never in files, logs or reports. |
+| **People and camera** | faces and names only on the PC, only when enrolled and with consent. Camera games analyse the image only in the browser – no image leaves the PC. |
+| **Data** | map, sightings and memory stay on this PC and never go into a Knowlet. |
+| **Costs** | paid cloud training only starts after two clicks. |
+
+Please report security issues privately: [`SECURITY.md`](SECURITY.md).
+
+## Accessibility
+
+The goal is **WCAG 2.2 AA**: fully usable by keyboard, contrast checked, “reduce motion” respected. Every view is
+checked automatically with axe-core; testing with real screen readers (NVDA, VoiceOver) is still to do – feedback is
+very welcome. Details (German): [`docs/barrierefreiheit.md`](docs/barrierefreiheit.md).
+
+## Documentation
+
+- [User manual](docs/handbuch.md) (German) – every area and feature in detail
+- [ARCHITECTURE.md](ARCHITECTURE.md) (German) – structure, layers and where things belong
+- [CHANGELOG.md](CHANGELOG.md) (German) · [Release notes](docs/releases/) (English and German) · [Roadmap](docs/ROADMAP.md)
+
+## Contributing
+
+Contributions are welcome – code, translations, dances, tests or reports from a real robot. Start with
+[`CONTRIBUTING.md`](CONTRIBUTING.md) and the issues labelled
+[`good first issue`](https://github.com/knowlin-ai/knowlin/labels/good%20first%20issue). Questions and show & tell are
+welcome in [Discussions](https://github.com/knowlin-ai/knowlin/discussions). Please follow the
+[Code of Conduct](CODE_OF_CONDUCT.md).
+
+## Legal and sources
+
+Knowlin is a **free, non-commercial hobby project** for small robots. It is not affiliated with, endorsed or
+reviewed by Pollen Robotics or Hugging Face. Knowlin is licensed under the **Apache License 2.0** (`LICENSE`), © 2026 The Knowlin Authors; built with Claude
+(Anthropic). “Microduck” and “Reachy Mini” are names of Pollen Robotics; “Open Duck Mini” is a project by Antoine Pirrone. Contributions and their licences are listed in
+`NOTICE` and in the app under System → Settings → About.
+On GitHub: [knowlin-ai/knowlin](https://github.com/knowlin-ai/knowlin) – maintainer [@knowlin-dev](https://github.com/knowlin-dev).
+
+| What | Source | Licence | In Knowlin |
+|---|---|---|---|
+| 3D parts (STL) | [pollen-robotics/microduck_rl](https://github.com/pollen-robotics/microduck_rl) | [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/), © Pollen Robotics | **not included** – downloaded on first start and prepared on your PC |
+| Robot model (MJCF) | [pollen-robotics/microduck_rl](https://github.com/pollen-robotics/microduck_rl) | Apache-2.0 | **not included** – as above |
+| Policies | [pollen-robotics/microduck-policies](https://huggingface.co/pollen-robotics/microduck-policies) | see there | **not included** – loaded on request |
+| 14 emotions, sounds | [pollen-robotics/microduck_emotions](https://github.com/pollen-robotics/microduck_emotions) | Apache-2.0 | converted (`tools/import_emotions.py`) |
+| Duck voice, gesture sounds | [microduck_emotions](https://github.com/pollen-robotics/microduck_emotions), [microduck](https://github.com/pollen-robotics/microduck) | Apache-2.0 | rendered with Pollen's synthesiser |
+| three.js | [mrdoob/three.js](https://github.com/mrdoob/three.js) | MIT | `static/vendor/` |
+| IBM Plex Sans and Mono | [IBM/plex](https://github.com/IBM/plex) | SIL OFL 1.1 | `static/vendor/plex/` |
+| Design | [IBM Carbon Design System](https://carbondesignsystem.com) | Apache-2.0 | rebuilt in `static/ds/` |
+| Reachy Mini: 3D parts, kinematics | [pollen-robotics/reachy_mini](https://github.com/pollen-robotics/reachy_mini) | hardware CC BY-NC-SA 4.0, software Apache-2.0 | **not included** – downloaded on request and prepared on your PC |
+| Reachy Mini: emotions and dances | Pollen's datasets on Hugging Face | see there | **not included** – downloaded on request |
+| Hand detection (camera games) | MediaPipe Hand Landmarker: [`@mediapipe/tasks-vision` 0.10.21](https://www.npmjs.com/package/@mediapipe/tasks-vision) and the model `hand_landmarker.task` (float16/1) by Google | Apache-2.0 | **not included** – downloaded only on click (fixed version, checksums in `modell/hand_quellen.json`), runs only in the browser |
+| Open Duck Mini v2: 3D model | [apirrone/Open_Duck_Mini](https://github.com/apirrone/Open_Duck_Mini) | Apache-2.0 | prepared and included (`static/model/open_duck_mini.dpm`, see `LIZENZ-open-duck-mini.md`) |
+
+All changes per version: [`CHANGELOG.md`](CHANGELOG.md) (German).