aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-10-28 10:07:54 +0100
committerDanilo M. <danix@danix.xyz>2026-10-28 10:07:54 +0100
commit20c61174f8f5863b931775bda85f641003465085 (patch)
treeb68da040ddde7e5c7782a45a55b59cac6140003a /README.md
downloadgenerat3D-20c61174f8f5863b931775bda85f641003465085.tar.gz
generat3D-20c61174f8f5863b931775bda85f641003465085.zip
Initial commit: generat3D, Daz DSON evaluator for Linux
generat3D evaluates Daz DSON scenes (.duf plus a content library) natively on Linux and writes the .dbz file used by Blender's Diffeomorphic DAZ Importer, removing the need for Daz Studio. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7fb153f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,49 @@
+# generat3D
+
+Use Daz 3D characters on Linux without Daz Studio. generat3D reads a Daz
+scene (`.duf`) and your installed content library, evaluates the figure's
+morphs and formulas the way Daz does, and writes the `.dbz` file that the
+[Diffeomorphic DAZ Importer](https://github.com/Diffeomorphic/import_daz)
+for Blender uses for exact mesh fitting. Normally that file can only be
+produced by running a script inside Daz Studio, which has no Linux version.
+
+Status: in design. Version 1 targets Genesis 9 figures: shape morphs,
+formula links between dials, and joint centers. Clothing fitting, HD morphs
+and geografts come later.
+
+generat3D is not affiliated with or endorsed by Daz 3D. It ships no Daz
+content: you need your own licensed content library.
+
+## Requirements
+
+- Python 3.11 or newer
+- numpy
+- A Daz content library (product zips extracted into a library folder)
+
+## Usage
+
+Planned interface:
+
+```
+python -m generat3d scene.duf [-L ROOT ...] [-o OUT.dbz]
+```
+
+Library roots come from `-L` or from `~/.config/generat3d/config.toml`:
+
+```toml
+library_roots = ["/home/you/Daz/My Library"]
+```
+
+## License
+
+Copyright (C) 2026 Danilo M. <danix@danix.xyz>
+
+GPLv2 or later. See [LICENSE](LICENSE) for the full text.
+
+## Development Approach
+
+This project is developed using AI-assisted tools. Code is generated with the help of AI based on human-provided specifications, design decisions, and iterative feedback.
+
+All contributions are reviewed, tested, and curated by the maintainer before being included in the codebase. AI is used as a productivity and exploration tool, while human oversight remains central to all decisions.
+
+The goal is to combine the flexibility of AI-assisted development with standard open-source practices such as transparency, review, and accountability.