0.30.1 (#190)

* address circular import issues

* set 0.30.1

* docs

* numpy to 2

* docs

docs/getting-started/installation/troubleshoot.md

@@ -2,13 +2,17 @@
 
 ## Windows
 
-### Installation fails with "Microsoft Visual C++" error
+### Installation fails with "Microsoft Visual C++" or "ValueError: The onnxruntime python package is not installed." errors
     
-If your installation errors with a notification to upgrade "Microsoft Visual C++" go to https://visualstudio.microsoft.com/visual-cpp-build-tools/ and click "Download Build Tools" and run it.
+If your installation errors with a notification to upgrade "Microsoft Visual C++" go to [https://visualstudio.microsoft.com/visual-cpp-build-tools/](https://visualstudio.microsoft.com/visual-cpp-build-tools/) and click "Download Build Tools" and run it.
 
 -  During installation make sure you select the C++ development package (upper left corner)
 -  Run `reinstall.bat` inside talemate directory
 
+### Frontend fails with errors
+
+- ensure none of the directories have special characters in them, this can cause issues with the frontend. so no `(1)` in the directory name.
+
 ## Docker
 
 ### Docker has created `config.yaml` directory

docs/getting-started/installation/windows.md

@@ -2,6 +2,7 @@
 
 1. Download and install Python 3.10 - 3.13 from the [official Python website](https://www.python.org/downloads/windows/).
     - [Click here for direct link to python 3.11.9 download](https://www.python.org/downloads/release/python-3119/)
+    - June 2025: people have reported issues with python 3.13 still, due to some dependencies not being available yet, if you run into issues during installation try downgrading.
 1. Download and install Node.js from the [official Node.js website](https://nodejs.org/en/download/prebuilt-installer). This will also install npm.
 1. Download the Talemate project to your local machine. Download from [the Releases page](https://github.com/vegu-ai/talemate/releases).
 1. Unpack the download and run `install.bat` by double clicking it. This will set up the project on your local machine.

pyproject.toml

@@ -45,7 +45,7 @@ tiktoken = ">=0.5.1"
 nltk = ">=3.8.1"
 huggingface-hub = ">=0.20.2"
 RestrictedPython = ">7.1"
-numpy = "^1"
+numpy = "^2"
 aiofiles = ">=24.1.0"
 pyyaml = ">=6.0"
 limits = ">=5.0"

src/talemate/__init__.py

@@ -1,5 +1,3 @@
-from .agents import Agent
-from .client import TextGeneratorWebuiClient
 from .tale_mate import *
 
 from .version import VERSION

src/talemate/agents/summarize/__init__.py

@@ -4,7 +4,7 @@ import re
 import dataclasses
 
 import structlog
-
+from typing import TYPE_CHECKING
 import talemate.data_objects as data_objects
 import talemate.emit.async_signals
 import talemate.util as util
@@ -18,7 +18,6 @@ from talemate.scene_message import (
     ReinforcementMessage,
 )
 from talemate.world_state.templates import GenerationOptions
-from talemate.tale_mate import Character
 from talemate.instance import get_agent
 from talemate.exceptions import GenerationCancelled
 import talemate.game.focal as focal
@@ -40,6 +39,9 @@ from .analyze_scene import SceneAnalyzationMixin
 from .context_investigation import ContextInvestigationMixin
 from .layered_history import LayeredHistoryMixin
 
+if TYPE_CHECKING:
+    from talemate.tale_mate import Character
+
 log = structlog.get_logger("talemate.agents.summarize")
 
 talemate.emit.async_signals.register(
@@ -534,7 +536,7 @@ class SummarizeAgent(
         if not extra_context:
             extra_context = ""
             
-        mentioned_characters: list[Character] = self.scene.parse_characters_from_text(
+        mentioned_characters: list["Character"] = self.scene.parse_characters_from_text(
             text + extra_context,
             exclude_active=True
         )

src/talemate/agents/world_state/__init__.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import dataclasses
 import json
 import time
+from typing import TYPE_CHECKING
 
 import isodate
 import structlog
@@ -25,7 +26,9 @@ from talemate.agents.registry import register
 
 from .character_progression import CharacterProgressionMixin
 import talemate.agents.world_state.nodes
-from talemate.tale_mate import Character
+
+if TYPE_CHECKING:
+    from talemate.tale_mate import Character
 
 log = structlog.get_logger("talemate.agents.world_state")
 
@@ -506,13 +509,13 @@ class WorldStateAgent(
 
     @set_processing
     async def update_reinforcement(
-        self, question: str, character: str | Character = None, reset: bool = False
+        self, question: str, character: "str | Character" = None, reset: bool = False
     ) -> str:
         """
         Queries a single re-inforcement
         """
         
-        if isinstance(character, Character):
+        if isinstance(character, self.scene.Character):
             character = character.name
         
         message = None

src/talemate/version.py

@@ -1,3 +1,3 @@
 __all__ = ["VERSION"]
 
-VERSION = "0.30.0"
+VERSION = "0.30.1"

talemate_frontend/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "talemate_frontend",
-  "version": "0.30.0",
+  "version": "0.30.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "talemate_frontend",
-      "version": "0.30.0",
+      "version": "0.30.1",
       "dependencies": {
         "@codemirror/fold": "github:codemirror/fold",
         "@codemirror/lang-json": "github:codemirror/lang-json",

talemate_frontend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "talemate_frontend",
-  "version": "0.30.0",
+  "version": "0.30.1",
   "private": true,
   "scripts": {
     "serve": "vue-cli-service serve",