convoviz 0.3.1__tar.gz → 0.3.3__tar.gz

{convoviz-0.3.1 → convoviz-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: convoviz
-Version: 0.3.1
+Version: 0.3.3
 Summary: Get analytics and visualizations on your ChatGPT data!
 Keywords: markdown,chatgpt,openai,visualization,analytics,json,export,data-analysis,obsidian
 Author: Mohamed Cheikh Sidiya
@@ -25,7 +25,7 @@ Description-Content-Type: text/markdown
 
 # Convoviz 📊: Visualize your entire ChatGPT data
 
-Convert your ChatGPT history into well-formatted Markdown files. Additionally, visualize your data with word clouds 🔡☁️, view your prompt history graphs 📈, and access all your custom instructions 🤖 in a single location.
+Convert your ChatGPT history into well-formatted Markdown files. Visualize your data with word clouds 🔡☁️ and usage graphs 📈.
 
 ![GitHub last commit](https://img.shields.io/github/last-commit/mohamed-chs/chatgpt-history-export-to-md)
 ![GitHub issues](https://img.shields.io/github/issues/mohamed-chs/chatgpt-history-export-to-md)
@@ -42,24 +42,41 @@ See examples [here](demo).
 
 ### 1. Export Your ChatGPT Data 🗂
 
-- Sign in at [chat.openai.com](https://chat.openai.com).
+- Sign in at [chatgpt.com](https://chatgpt.com).
 - Navigate: Profile Name (bottom left) -> **Settings** -> **Data controls** -> **Export** -> **Confirm export**.
 - Await email from OpenAI and download the `.zip` file.
 
 ### 2. Install the tool 🛠
 
-With uv ([astral-sh/uv](https://github.com/astral-sh/uv?tab=readme-ov-file#highlights)):
+First, install [uv](https://github.com/astral-sh/uv) (if you don't have it):
+
+MacOS / Linux:
 
 ```bash
-uv tool install convoviz[viz]
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+Windows (PowerShell):
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 ```
 
-or pipx:
+Then install convoviz:
+
 ```bash
-pipx install convoviz[viz]
+uv tool install "convoviz[viz]"
 ```
 
-The `[viz]` extra includes graphs and word clouds. If you only need markdown conversion, you can skip it for a faster install (`uv tool install convoviz`).
+The `[viz]` extra includes graphs and word clouds. Skip it for a faster markdown-only install.
+
+#### Alternative: pip
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate  # Windows: .venv\Scripts\activate
+pip install "convoviz[viz]"
+```
 
 ### 3. Run the tool 🏃‍♂️
 
@@ -77,22 +94,15 @@ You can provide arguments directly to skip the prompts:
 convoviz --input path/to/your/export.zip --output path/to/output/folder
 ```
 
-##### Selective Output Generation
+##### Selective Output
 
-By default, Convoviz generates all outputs (Markdown files, graphs, and word clouds). You can select specific outputs using the `--outputs` flag:
+By default, all outputs are generated. Use `--outputs` to pick specific ones:
 
 ```bash
-# Generate only Markdown files (fastest)
-convoviz --input export.zip --outputs markdown
-
-# Generate Markdown and graphs (no word clouds)
 convoviz --input export.zip --outputs markdown --outputs graphs
-
-# Generate all outputs (default behavior)
-convoviz --input export.zip --outputs markdown --outputs graphs --outputs wordclouds
 ```
 
-In interactive mode, you'll be prompted to select which outputs to generate.
+Options: `markdown`, `graphs`, `wordclouds`. In interactive mode, you'll be prompted.
 
 ##### Other Notes
 

{convoviz-0.3.1 → convoviz-0.3.3}/README.md

@@ -1,6 +1,6 @@
 # Convoviz 📊: Visualize your entire ChatGPT data
 
-Convert your ChatGPT history into well-formatted Markdown files. Additionally, visualize your data with word clouds 🔡☁️, view your prompt history graphs 📈, and access all your custom instructions 🤖 in a single location.
+Convert your ChatGPT history into well-formatted Markdown files. Visualize your data with word clouds 🔡☁️ and usage graphs 📈.
 
 ![GitHub last commit](https://img.shields.io/github/last-commit/mohamed-chs/chatgpt-history-export-to-md)
 ![GitHub issues](https://img.shields.io/github/issues/mohamed-chs/chatgpt-history-export-to-md)
@@ -17,24 +17,41 @@ See examples [here](demo).
 
 ### 1. Export Your ChatGPT Data 🗂
 
-- Sign in at [chat.openai.com](https://chat.openai.com).
+- Sign in at [chatgpt.com](https://chatgpt.com).
 - Navigate: Profile Name (bottom left) -> **Settings** -> **Data controls** -> **Export** -> **Confirm export**.
 - Await email from OpenAI and download the `.zip` file.
 
 ### 2. Install the tool 🛠
 
-With uv ([astral-sh/uv](https://github.com/astral-sh/uv?tab=readme-ov-file#highlights)):
+First, install [uv](https://github.com/astral-sh/uv) (if you don't have it):
+
+MacOS / Linux:
 
 ```bash
-uv tool install convoviz[viz]
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+Windows (PowerShell):
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 ```
 
-or pipx:
+Then install convoviz:
+
 ```bash
-pipx install convoviz[viz]
+uv tool install "convoviz[viz]"
 ```
 
-The `[viz]` extra includes graphs and word clouds. If you only need markdown conversion, you can skip it for a faster install (`uv tool install convoviz`).
+The `[viz]` extra includes graphs and word clouds. Skip it for a faster markdown-only install.
+
+#### Alternative: pip
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate  # Windows: .venv\Scripts\activate
+pip install "convoviz[viz]"
+```
 
 ### 3. Run the tool 🏃‍♂️
 
@@ -52,22 +69,15 @@ You can provide arguments directly to skip the prompts:
 convoviz --input path/to/your/export.zip --output path/to/output/folder
 ```
 
-##### Selective Output Generation
+##### Selective Output
 
-By default, Convoviz generates all outputs (Markdown files, graphs, and word clouds). You can select specific outputs using the `--outputs` flag:
+By default, all outputs are generated. Use `--outputs` to pick specific ones:
 
 ```bash
-# Generate only Markdown files (fastest)
-convoviz --input export.zip --outputs markdown
-
-# Generate Markdown and graphs (no word clouds)
 convoviz --input export.zip --outputs markdown --outputs graphs
-
-# Generate all outputs (default behavior)
-convoviz --input export.zip --outputs markdown --outputs graphs --outputs wordclouds
 ```
 
-In interactive mode, you'll be prompted to select which outputs to generate.
+Options: `markdown`, `graphs`, `wordclouds`. In interactive mode, you'll be prompted.
 
 ##### Other Notes
 

{convoviz-0.3.1 → convoviz-0.3.3}/convoviz/analysis/__init__.py

@@ -1,6 +1,6 @@
 """Data analysis and visualization for convoviz.
 
-Requires the [viz] extra: pip install convoviz[viz]
+Requires the [viz] extra: uv tool install "convoviz[viz]"
 """
 
 __all__ = [

{convoviz-0.3.1 → convoviz-0.3.3}/convoviz/pipeline.py

@@ -127,7 +127,7 @@ def run_pipeline(config: ConvovizConfig) -> None:
         except ModuleNotFoundError as e:
             raise ConfigurationError(
                 "Graph generation requires matplotlib. "
-                "Install with: pip install convoviz[viz]"
+                'Reinstall with the [viz] extra: uv tool install "convoviz[viz]"'
             ) from e
 
         graph_folder = output_folder / "Graphs"
@@ -151,7 +151,7 @@ def run_pipeline(config: ConvovizConfig) -> None:
         except ModuleNotFoundError as e:
             raise ConfigurationError(
                 "Word cloud generation requires wordcloud and nltk. "
-                "Install with: pip install convoviz[viz]"
+                'Reinstall with the [viz] extra: uv tool install "convoviz[viz]"'
             ) from e
 
         wordcloud_folder = output_folder / "Word-Clouds"

{convoviz-0.3.1 → convoviz-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "convoviz"
-version = "0.3.1"
+version = "0.3.3"
 description = "Get analytics and visualizations on your ChatGPT data!"
 license = "MIT"
 keywords = [