Talkinghead next4: configurability!

[Technologicat]

• Configurability!
  • Add new API endpoints load_emotion_templates, load_animator_settings.
  • Needs matching PR for the frontend to actually send the configs, https://github.com/SillyTavern/SillyTavern/pull/1683.
  • No GUI yet, just JSON files in the character's folder on the client end.
• Docs, docs, docs!
  • Document in the talkinghead README how to use the new configurability.
  • Minor updates to main README.
• Small fixes:
  • Talkinghead now manages its threads internally, so there's no need to run launch in a separate thread. Better for predictable ordering of startup messages for the ST-extras server.
  • In the startup message of the talkinghead module, highlight the name talkinghead, the CUDA device used, and the model variant. Makes it more explicit that it may use a CUDA device different from that of most other extras modules.
• Reorganize server.py to format it more like a standard Python script.
  • Standard ordering for imports, then functions first (grouped by topic), and the main program at the end.
  • I kept the scoping as-is. I was tempted to move the main program into a main function and call it if __name__ == "__main__", as the pythonic equivalent to the top-level JS IIFE goes, but OTOH, flask makes that difficult (since we need to instantiate app to make @app.route available for the API endpoint definitions), and server.py is not intended to be imported as a module into other scripts anyway. So there would be no practical benefit, other than IDEs being able to catch unused variables.
  • @Cohee1207: This is commit 332b4ed. If you don't like this change, I can revert it. My own opinion is that many pythonistas will find the code more quickly readable this way.
• Update TODO.
  • I noticed a few more per-frame timings that need to be fixed later, particularly the microsway, and dynamic postprocessor effects.

~THIS PR IS NOT YET FINAL:~ EDIT: Now it is. :)

~I will add one more feature - namely, the manual poser doesn't yet automatically generate a suitably formatted _emotions.json. This will only take a few lines of code, but I'm out of time right now - I'll finish this either tonight or over the weekend. I'll update the PR once done.~

~Meanwhile, the rest can be reviewed.~

Tested with the following SillyTavern/public/characters/characternamehere/_animator.json (note: per-character config, at the client end!): EDIT: This configuration is now provided as an example in the talkinghead README.

{"target_fps": 25,
 "pose_interpolator_step": 0.1,
 "blink_interval_min": 2.0,
 "blink_interval_max": 5.0,
 "blink_probability": 0.03,
 "blink_confusion_duration": 10.0,
 "talking_fps": 12,
 "talking_morph": "mouth_aaa_index",
 "sway_morphs": ["head_x_index", "head_y_index", "neck_z_index", "body_y_index", "body_z_index"],
 "sway_interval_min": 5.0,
 "sway_interval_max": 10.0,
 "sway_macro_strength": 0.6,
 "sway_micro_strength": 0.02,
 "breathing_cycle_duration": 4.0,
 "postprocessor_chain": [["bloom", {}],
                         ["translucency", {"alpha": 0.9}],
                         ["alphanoise", {"magnitude": 0.1, "sigma": 0.0}],
                         ["banding", {}],
                         ["scanlines", {"dynamic": true}]
                        ]
}

The rest are defaults, but the "postprocessor_chain" makes the character into a scifi hologram.

[Technologicat]

Now, when doing a batch export, the manual poser generates _emotions.json (in the same output folder). This file can be used as SillyTavern/public/characters/characternamehere/_emotions.json (per-character emotion templates).

[Technologicat]

Made some doc updates. That part is still WIP, but documentation could be a separate PR.