fullseye 0.1.0__tar.gz

fullseye-0.1.0/AUTHORS

@@ -0,0 +1,6 @@
+fullseye (imgevolve) — Authors
+===============================
+
+Kazufumi Furuse <kazufumi@furuse.work>  (https://github.com/furuse-kazufumi)
+
+fullseye is authored and maintained by Kazufumi Furuse.

fullseye-0.1.0/LICENSE

@@ -0,0 +1,201 @@
+                                 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 Kazufumi Furuse
+
+   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.

fullseye-0.1.0/NOTICE

@@ -0,0 +1,7 @@
+fullseye
+Copyright (c) 2026 Kazufumi Furuse
+
+This product includes software developed by Kazufumi Furuse
+(https://github.com/furuse-kazufumi).
+
+Licensed under the Apache License, Version 2.0. See the LICENSE file.

fullseye-0.1.0/PKG-INFO

@@ -0,0 +1,283 @@
+Metadata-Version: 2.4
+Name: fullseye
+Version: 0.1.0
+Summary: Evolvable image-processing operator library and honest pipeline designer (numpy-native, optional GPU)
+Author-email: Kazufumi Furuse <kazufumi@furuse.work>
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/furuse-kazufumi/fullseye
+Project-URL: Repository, https://github.com/furuse-kazufumi/fullseye
+Project-URL: Documentation, https://github.com/furuse-kazufumi/fullseye/tree/master/docs
+Project-URL: Operator corpus (RAG), https://github.com/furuse-kazufumi/fullseye/tree/master/docs/ops
+Project-URL: Bug tracker, https://github.com/furuse-kazufumi/fullseye/issues
+Keywords: image-processing,computer-vision,evolutionary-algorithm,pipeline,operators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+License-File: AUTHORS
+Requires-Dist: numpy>=1.23
+Requires-Dist: scipy>=1.9
+Provides-Extra: opencv
+Requires-Dist: opencv-python>=4.6; extra == "opencv"
+Provides-Extra: skimage
+Requires-Dist: scikit-image>=0.20; extra == "skimage"
+Provides-Extra: pil
+Requires-Dist: Pillow>=9; extra == "pil"
+Provides-Extra: wavelets
+Requires-Dist: PyWavelets>=1.4; extra == "wavelets"
+Provides-Extra: gpu
+Requires-Dist: torch>=2.0; extra == "gpu"
+Requires-Dist: kornia>=0.7; extra == "gpu"
+Provides-Extra: extra
+Requires-Dist: mahotas>=1.4; extra == "extra"
+Requires-Dist: SimpleITK>=2.2; extra == "extra"
+Provides-Extra: gui
+Requires-Dist: PySide6>=6.5; extra == "gui"
+Provides-Extra: video
+Requires-Dist: imageio>=2.28; extra == "video"
+Requires-Dist: imageio-ffmpeg>=0.4; extra == "video"
+Provides-Extra: audio
+Requires-Dist: soundfile>=0.12; extra == "audio"
+Provides-Extra: volume
+Requires-Dist: SimpleITK>=2.2; extra == "volume"
+Requires-Dist: tifffile>=2023.1; extra == "volume"
+Provides-Extra: raster
+Requires-Dist: imageio>=2.28; extra == "raster"
+Requires-Dist: tifffile>=2023.1; extra == "raster"
+Provides-Extra: gltf
+Requires-Dist: pygltflib>=1.16; extra == "gltf"
+Provides-Extra: lidar
+Requires-Dist: laspy>=2.5; extra == "lidar"
+Requires-Dist: lazrs>=0.5; extra == "lidar"
+Provides-Extra: pcd
+Requires-Dist: pypcd4>=1.4; extra == "pcd"
+Provides-Extra: threed
+Requires-Dist: torch>=2.0; extra == "threed"
+Requires-Dist: scikit-image>=0.20; extra == "threed"
+Requires-Dist: SimpleITK>=2.2; extra == "threed"
+Provides-Extra: serial
+Requires-Dist: pyserial>=3.5; extra == "serial"
+Provides-Extra: modbus
+Requires-Dist: pymodbus>=3.0; extra == "modbus"
+Provides-Extra: mqtt
+Requires-Dist: paho-mqtt>=1.6; extra == "mqtt"
+Provides-Extra: opcua
+Requires-Dist: asyncua>=1.0; extra == "opcua"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-cov>=4; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Provides-Extra: all
+Requires-Dist: opencv-python>=4.6; extra == "all"
+Requires-Dist: scikit-image>=0.20; extra == "all"
+Requires-Dist: Pillow>=9; extra == "all"
+Requires-Dist: PyWavelets>=1.4; extra == "all"
+Requires-Dist: torch>=2.0; extra == "all"
+Requires-Dist: kornia>=0.7; extra == "all"
+Requires-Dist: mahotas>=1.4; extra == "all"
+Requires-Dist: SimpleITK>=2.2; extra == "all"
+Requires-Dist: PySide6>=6.5; extra == "all"
+Requires-Dist: imageio>=2.28; extra == "all"
+Requires-Dist: imageio-ffmpeg>=0.4; extra == "all"
+Requires-Dist: tifffile>=2023.1; extra == "all"
+Dynamic: license-file
+
+# Fullseye
+
+[![CI](https://github.com/furuse-kazufumi/fullseye/actions/workflows/ci.yml/badge.svg)](https://github.com/furuse-kazufumi/fullseye/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/fullseye)](https://pypi.org/project/fullseye/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
+
+**An in-house, numpy-native image-processing operator library and evolutionary
+pipeline designer.** Every operator is reimplemented from published algorithms and
+open-source libraries (OpenCV, scikit-image, SciPy, Pillow, PyWavelets, SimpleITK,
+mahotas, kornia/torch), given a single typed interface, and contract-tested
+(finite, deterministic, sort-typed). On top of the operators sits an evolutionary
+search that *designs* pipelines and gates them honestly on a held-out set.
+
+Two ways to use it: **apply known operators** (most of the time), or **evolve a new
+pipeline** when no single operator solves the task. It is `pip`-installable and works
+on plain numpy arrays, so other projects can drop it into a vision pipeline directly.
+
+<!-- Absolute raw URLs on purpose: this README doubles as the PyPI long description,
+     where repo-relative image paths break. -->
+![Fullseye's own renderer: SDF smooth-union sculpture with AO, soft shadows and ACES tonemap — pure numpy](https://raw.githubusercontent.com/furuse-kazufumi/fullseye/master/docs/articles/assets/render_beauty_hero.png)
+
+*Rendered by Fullseye's numpy renderer (SDF → marching cubes → AO / soft shadows / ACES). More real outputs below.*
+
+## Install
+
+```bash
+pip install fullseye        # PyPI (numpy + scipy core)
+pip install "fullseye[all]" # + opencv, scikit-image, Pillow, PyWavelets, SimpleITK, kornia/torch, PySide6
+# from a checkout: pip install -e .   (per-backend extras: .[opencv] .[skimage] .[gpu] ...)
+```
+
+PyPI: <https://pypi.org/project/fullseye/> · Source / issues / operator corpus:
+GitHub (linked from the PyPI sidebar). After installing, `fullseye-rag` sets up the
+Claude Code RAG skill; `py -3.11 tools/update_fullseye.py` updates a checkout without
+touching your environment (see `docs/AI_RAG_GUIDE.md`).
+
+Only numpy and scipy are required; every other backend is optional and only its own
+operators are affected when it is absent (graceful degradation). GPU is opt-in.
+
+## Quickstart (programmatic API)
+
+```python
+import fullseye, numpy as np
+
+frame = np.asarray(img, np.float64)                 # gray H×W in [0,1] (H×W×3 for color)
+edges = fullseye.apply(frame, "sobel_amp")          # numpy in, numpy out
+seg   = fullseye.apply(frame, "otsu")               # image → region (binary {0,1})
+n     = fullseye.apply(seg,   "count_obj")          # region → feature → a float
+out   = fullseye.run_pipeline(frame, ["gaussian", "sobel_amp", "otsu"])          # shared knobs
+out   = fullseye.run_pipeline(frame, [("gaussian",0.3,0.5), ("otsu",0.4,0.5)])   # per-stage knobs
+fullseye.list_ops(sort="region"); fullseye.op_names()   # discover
+```
+
+`apply(image, name, a=0.5, b=0.5)` and `run_pipeline` take an operator name and two
+knobs in `[0, 1]`. Feature operators return a Python float; contour operators a dict.
+
+## Operator library
+
+**~1000 typed operators** (measured: 731 distinct 2-D across 46 categories + 265 3-D
+across 55 categories), covering denoising, smoothing, sharpening,
+thresholding/segmentation, morphology, edge/corner/blob detection, distance
+transforms, color-space conversion, texture/shape features, contours, and the 3-D
+modality (point clouds / meshes / volumes / SDF / 6-DoF pose). Sorts: `image` (gray
+`[0,1]`), `color` (RGB), `region` (binary), `feature` (scalar), `contour`, `volume`.
+
+Every operator carries a machine-readable Markdown note under `docs/ops/`
+(call form, type contract, HALCON counterpart, references, author/license/version
+fingerprint) — a single source of truth that generates the Studio help pages and
+doubles as a **retrieval (RAG) corpus for AI coding assistants**: an agent such as
+Claude Code can look up operators by contract, chain them by sort, and inspect every
+intermediate result. One command installs the bundled Claude Code skill and pins the
+corpus path (`py -3.11 tools/setup_claude_rag.py` — see `docs/AI_RAG_GUIDE.md`).
+Coverage against HALCON's 2313 operators is measured, not asserted
+(`py -3.11 imgevolve.py coverage`).
+
+```bash
+py -3.11 imgevolve.py ops --search edge      # search implemented operators
+py -3.11 imgevolve.py apply gaussian in.png out.png --a 0.6
+py -3.11 imgevolve.py pipeline in.png out.png --ops "gaussian,sobel_amp,otsu"
+py -3.11 imgevolve.py coverage               # honest coverage numbers
+```
+
+Adding one operator makes evolution, code generation, the catalog, and the
+machine-readable index (`docs/OP_INDEX.json`) follow automatically.
+
+![Real outputs of classic 2-D vision operators — edges, segmentation, contour measurement](https://raw.githubusercontent.com/furuse-kazufumi/fullseye/master/docs/articles/assets/vision_ops_montage.png)
+
+## Perception stack (robotics-friendly)
+
+Building blocks that turn frames into geometry and objects — the pieces a robot
+needs to perceive, measure, and act. A **sensor-simulation suite** (pseudo-LiDAR,
+stereo, event camera / DVS, photometric stereo, TSDF fusion, polarization, focus
+stacking) lets you develop and test perception pipelines without hardware:
+
+![Physical-AI sensor simulation suite — pseudo-LiDAR, stereo depth, event camera (DVS), focus stacking, polarization, camera+IMU Kalman fusion](https://raw.githubusercontent.com/furuse-kazufumi/fullseye/master/docs/articles/assets/physical_ai_montage.png)
+
+The **3-D side is where Fullseye differentiates most**: 265 typed 3-D operators
+spanning point clouds / meshes / volumes / SDF — 3-D feature descriptors
+(SHOT, FPFH, spin images), TSDF fusion, fringe projection, photometric stereo,
+superquadric fitting, medial axis, geodesic distance, visual hull, and
+boundary-preserving manifold-strict QEM decimation — all pure numpy behind one
+typed registry. Real data, real numbers (asteroid 25143 Itokawa, JAXA
+Hayabusa / Gaskell shape model):
+
+![Asteroid 25143 Itokawa real point cloud — curvature analysis, ICP self-registration (rot err 0.027°), PCA canonical pose](https://raw.githubusercontent.com/furuse-kazufumi/fullseye/master/docs/articles/assets/itokawa_montage.png)
+
+```python
+import fullseye as fs
+disp  = fs.disparity_map(left, right, max_disp=16)         # dense stereo (block matching)
+Z     = fs.depth_from_disparity(disp, focal=f, baseline=B) # Z = f·B/d
+pts   = fs.reproject_to_points(Z, fx=f, fy=f)              # point cloud (N,3)
+grid,_= fs.elevation_map(world_pts, cell=0.05)            # 2.5-D terrain heightmap
+ok    = fs.traversability(grid, cell=0.05, max_step=0.1)  # foothold / obstacle mask
+objs  = fs.segment_objects(frame, threshold="otsu")       # per-object records (geometry + descriptors)
+rgb   = fs.colorize_depth(Z); fs.save_ply("cloud.ply", pts)   # visualise / export (no matplotlib)
+```
+
+Motion, over time — feed it a real clip:
+
+```python
+frames = fs.read_frames("clip.mp4", gray=True, step=2)     # (T,H,W) float64 [0,1] (mp4/gif)
+for a, b in fs.frame_pairs(frames):
+    u, v = fs.optical_flow_lk(a, b)                         # dense flow; also track_points / motion_*
+```
+
+`fs.to_float01(x)` coerces uint8/uint16/bool/PIL/path inputs to float64 `[0,1]`;
+`fs.read_frames` / `iter_frames` / `write_video` / `probe` handle video I/O (see
+`docs/PERCEPTION_REALDATA.md` for measured results on real footage).
+
+## Evolutionary pipeline design
+
+When the task is "find an algorithm that maximizes metric *M* on my data", evolve one.
+Fitness is measured on the **training** split only; a **held-out** split is tracked but
+**never selected on**, so the reported generalization is honest rather than a fit to the
+evaluation set.
+
+```bash
+py -3.11 baseline.py --problem denoise --workdir out/mine     # honest floor first
+py -3.11 evolve.py   --problem denoise --workdir out/mine --gens 40 --pop 24
+py -3.11 robust.py   --problem denoise --workdir out/mine --seeds 5   # best-of-N, train-selected
+```
+
+## Performance (optional GPU batch backend)
+
+The default per-image path uses scipy/OpenCV. A batched `torch` fast path (`accel.py`,
+`--device cuda`) accelerates the compute-heavy vectorizable operators. Honest note: on
+CPU the batch path speeds up heavy operators (≈1.6–2.2×) but *loses* on trivial
+pointwise ops (tensor-conversion overhead); the real win is on GPU, where that overhead
+amortizes over large parallelism.
+
+## Fullseye Studio (HDevelop-style IDE)
+
+`fullseye-studio` (or `py -3.11 studio.py` from a checkout) opens the visual
+workbench: operator browser with generated help
+(2-D and 3-D), pipeline editor with per-stage timing, breakpoints, continue /
+run-from-line execution control, a variable window with watch expressions and
+right-click inspection, multi-window graphics scriptable from programs
+(`dev_open_window` / `dev_set_window` / `dev_set_window_extents`), worked-example
+galleries, and a tabbed **Python Editor** that opens any sample as editable, runnable
+code (F5, subprocess). Combined with the RAG corpus this is aimed at being an
+integrated environment for Physical-AI perception work: the AI writes and runs the
+pipeline, and the human inspects what it "sees" in the same windows.
+
+## Academic use
+
+Fullseye is designed to be citable and reproducible: per-operator notes carry real
+literature references (no fabricated DOIs), versions are pinned to the code by a
+registry fingerprint with a CI drift test, and evaluation follows the honest
+held-out discipline above. If you use it in academic work, please cite via
+`CITATION.cff`.
+
+## Documentation map
+
+Everything below lives in the repo — start at the guide that matches what you want to do:
+
+| You want to… | Read |
+|---|---|
+| See what the operators produce (result gallery) | `docs/GALLERY.md` |
+| Look up any of the ~1000 operators | `docs/ops/INDEX.md` (full TOC) · `docs/OP_CATALOG.md` (one-page catalog) |
+| Find real sample data (meshes / volumes / images, with licenses) | `docs/ops/SAMPLES.md` |
+| Use Fullseye as an AI/RAG knowledge base | `docs/AI_RAG_GUIDE.md` (+ `fullseye-rag`) |
+| Drive the Studio IDE | `docs/STUDIO_GUIDE.md` · `docs/HDEVELOP_DEV_OPS.md` (dev_* window ops) |
+| Add an operator | `docs/ADDING_OPS.md` · `CONTRIBUTING.md` |
+| Understand the language policy (en/ja) | `docs/I18N.md` |
+| Update a checkout safely | `tools/update_fullseye.py --check` |
+| Cite Fullseye | `CITATION.cff` |
+
+## Design principles
+
+- **Reimplemented from public knowledge** — published algorithms and open-source
+  libraries, unified behind one typed interface; not derived from any proprietary product.
+- **Honest by construction** — held-out data is never used for selection; coverage and
+  benchmark numbers are measured, not asserted; limitations are disclosed, not hidden.
+- **Optional heavy dependencies** — a numpy+scipy core always works; richer backends and
+  GPU are opt-in.
+
+## License
+
+Apache-2.0.