description add

Author: kubow

README.md

@@ -16,6 +16,12 @@ pip install -r requirements/base.txt  # for base package
 pip install -r requirements/streamlit.txt  # For Streamlit UI (browser)
 pip install -r requirements/kivy.txt  # For Kivy UI (desktop)
 
+# Or install by package extras
+pip install .  # core computation/storage package
+pip install .[api]  # FastAPI backend for Tauri/web frontends
+pip install .[streamlit]  # Streamlit UI + chart rendering
+pip install .[kivy]  # Kivy desktop UI + chart rendering
+
 # 3. Run the application
 python3 -m module --streamlit  # Streamlit UI (browser)
 python3 -m module --kivy  # Kivy UI (desktop)
@@ -27,6 +33,15 @@ For detailed setup instructions, troubleshooting, and advanced options, see the
 
 You can also explore [Documentation](./docs/README.md) to see more detailed overview.
 
+## Suggested Runtime Split
+
+- `core`: install `pip install .` for computation, workspace, and storage helpers
+- `api`: install `pip install .[api]` for a FastAPI sidecar/backend without UI dependencies
+- `streamlit`: install `pip install .[streamlit]` for the browser UI
+- `kivy`: install `pip install .[kivy]` for the native Python desktop UI
+
+For a `React frontend from Figma + FastAPI backend + Tauri packaging` setup, prefer `core + api` and keep the `ui_*` modules as optional developer-only frontends.
+
 ## How it works
 
 All the heavy lifting is made by a module [g-battaglia/kerykeion](https://github.com/g-battaglia/kerykeion), manipulation layer over [astrorigin/pyswisseph](https://github.com/astrorigin/pyswisseph) (also known as [swiss ephemerides](https://www.astro.com/swisseph/swephinfo_e.htm)), thus the license is inherited (GNU Affero GPL v3.0). Other dependencies are mentioned in the [requirements file](./requirements/base.in).
@@ -193,4 +208,3 @@ User Input
 
 Aspects are computed on demand from positions (not stored by default).
 ```
-