convoviz 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. convoviz/analysis/__init__.py +1 -1
  2. convoviz/pipeline.py +2 -2
  3. {convoviz-0.3.1.dist-info → convoviz-0.3.3.dist-info}/METADATA +28 -18
  4. {convoviz-0.3.1.dist-info → convoviz-0.3.3.dist-info}/RECORD +6 -6
  5. {convoviz-0.3.1.dist-info → convoviz-0.3.3.dist-info}/WHEEL +0 -0
  6. {convoviz-0.3.1.dist-info → convoviz-0.3.3.dist-info}/entry_points.txt +0 -0
convoviz/analysis/__init__.py CHANGED
@@ -1,6 +1,6 @@
1
1
  """Data analysis and visualization for convoviz.
2
2
 
3
- Requires the [viz] extra: pip install convoviz[viz]
3
+ Requires the [viz] extra: uv tool install "convoviz[viz]"
4
4
  """
5
5
 
6
6
  __all__ = [
convoviz/pipeline.py CHANGED
@@ -127,7 +127,7 @@ def run_pipeline(config: ConvovizConfig) -> None:
127
127
  except ModuleNotFoundError as e:
128
128
  raise ConfigurationError(
129
129
  "Graph generation requires matplotlib. "
130
- "Install with: pip install convoviz[viz]"
130
+ 'Reinstall with the [viz] extra: uv tool install "convoviz[viz]"'
131
131
  ) from e
132
132
 
133
133
  graph_folder = output_folder / "Graphs"
@@ -151,7 +151,7 @@ def run_pipeline(config: ConvovizConfig) -> None:
151
151
  except ModuleNotFoundError as e:
152
152
  raise ConfigurationError(
153
153
  "Word cloud generation requires wordcloud and nltk. "
154
- "Install with: pip install convoviz[viz]"
154
+ 'Reinstall with the [viz] extra: uv tool install "convoviz[viz]"'
155
155
  ) from e
156
156
 
157
157
  wordcloud_folder = output_folder / "Word-Clouds"
{convoviz-0.3.1.dist-info → convoviz-0.3.3.dist-info}/METADATA RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: convoviz
3
- Version: 0.3.1
3
+ Version: 0.3.3
4
4
  Summary: Get analytics and visualizations on your ChatGPT data!
5
5
  Keywords: markdown,chatgpt,openai,visualization,analytics,json,export,data-analysis,obsidian
6
6
  Author: Mohamed Cheikh Sidiya
@@ -25,7 +25,7 @@ Description-Content-Type: text/markdown
25
25
 
26
26
  # Convoviz 📊: Visualize your entire ChatGPT data
27
27
 
28
- 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.
28
+ Convert your ChatGPT history into well-formatted Markdown files. Visualize your data with word clouds 🔡☁️ and usage graphs 📈.
29
29
 
30
30
  ![GitHub last commit](https://img.shields.io/github/last-commit/mohamed-chs/chatgpt-history-export-to-md)
31
31
  ![GitHub issues](https://img.shields.io/github/issues/mohamed-chs/chatgpt-history-export-to-md)
@@ -42,24 +42,41 @@ See examples [here](demo).
42
42
 
43
43
  ### 1. Export Your ChatGPT Data 🗂
44
44
 
45
- - Sign in at [chat.openai.com](https://chat.openai.com).
45
+ - Sign in at [chatgpt.com](https://chatgpt.com).
46
46
  - Navigate: Profile Name (bottom left) -> **Settings** -> **Data controls** -> **Export** -> **Confirm export**.
47
47
  - Await email from OpenAI and download the `.zip` file.
48
48
 
49
49
  ### 2. Install the tool 🛠
50
50
 
51
- With uv ([astral-sh/uv](https://github.com/astral-sh/uv?tab=readme-ov-file#highlights)):
51
+ First, install [uv](https://github.com/astral-sh/uv) (if you don't have it):
52
+
53
+ MacOS / Linux:
52
54
 
53
55
  ```bash
54
- uv tool install convoviz[viz]
56
+ curl -LsSf https://astral.sh/uv/install.sh | sh
57
+ ```
58
+
59
+ Windows (PowerShell):
60
+
61
+ ```powershell
62
+ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
55
63
  ```
56
64
 
57
- or pipx:
65
+ Then install convoviz:
66
+
58
67
  ```bash
59
- pipx install convoviz[viz]
68
+ uv tool install "convoviz[viz]"
60
69
  ```
61
70
 
62
- 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`).
71
+ The `[viz]` extra includes graphs and word clouds. Skip it for a faster markdown-only install.
72
+
73
+ #### Alternative: pip
74
+
75
+ ```bash
76
+ python3 -m venv .venv
77
+ source .venv/bin/activate # Windows: .venv\Scripts\activate
78
+ pip install "convoviz[viz]"
79
+ ```
63
80
 
64
81
  ### 3. Run the tool 🏃‍♂️
65
82
 
@@ -77,22 +94,15 @@ You can provide arguments directly to skip the prompts:
77
94
  convoviz --input path/to/your/export.zip --output path/to/output/folder
78
95
  ```
79
96
 
80
- ##### Selective Output Generation
97
+ ##### Selective Output
81
98
 
82
- By default, Convoviz generates all outputs (Markdown files, graphs, and word clouds). You can select specific outputs using the `--outputs` flag:
99
+ By default, all outputs are generated. Use `--outputs` to pick specific ones:
83
100
 
84
101
  ```bash
85
- # Generate only Markdown files (fastest)
86
- convoviz --input export.zip --outputs markdown
87
-
88
- # Generate Markdown and graphs (no word clouds)
89
102
  convoviz --input export.zip --outputs markdown --outputs graphs
90
-
91
- # Generate all outputs (default behavior)
92
- convoviz --input export.zip --outputs markdown --outputs graphs --outputs wordclouds
93
103
  ```
94
104
 
95
- In interactive mode, you'll be prompted to select which outputs to generate.
105
+ Options: `markdown`, `graphs`, `wordclouds`. In interactive mode, you'll be prompted.
96
106
 
97
107
  ##### Other Notes
98
108
 
{convoviz-0.3.1.dist-info → convoviz-0.3.3.dist-info}/RECORD RENAMED
@@ -1,6 +1,6 @@
1
1
  convoviz/__init__.py,sha256=UjwkFEmRXhE-3qhsoGTG9XhtoL2cP0o4h3Sp9fcA2Ic,858
2
2
  convoviz/__main__.py,sha256=1qiGW13_SgL7wJi8iioIN-AAHGkNGnEl5q_RcPUrI0s,143
3
- convoviz/analysis/__init__.py,sha256=pmUm9yU7VtEbAea56uqgUvpicADVg9BWidgL227HZUU,648
3
+ convoviz/analysis/__init__.py,sha256=1dHjnw88mepSY3Q3U8lEvSqkuWPtkzpyYMgq0CIWoXk,654
4
4
  convoviz/analysis/graphs.py,sha256=4uGxVVnbDnBODPlu3g9jZPl6X3JEb4Ri1jXEekhV7-8,29681
5
5
  convoviz/analysis/wordcloud.py,sha256=tWQolVTILw40DXLDw6m7O8blDUBRrNG1FqRBA95ISEA,5844
6
6
  convoviz/assets/colormaps.txt,sha256=59TSGz428AxY14AEvymAH2IJ2RT9Mlp7Sy0N12NEdXQ,108
@@ -49,13 +49,13 @@ convoviz/models/collection.py,sha256=L658yKMNC6IZrfxYxZBe-oO9COP_bzVfRznnNon7tfU
49
49
  convoviz/models/conversation.py,sha256=ssx1Z6LM9kJIx3OucQW8JVoAc8zCdxj1iOLtie2B3ak,5678
50
50
  convoviz/models/message.py,sha256=0CJ9hJ1rQiesn1SgHqFgEgKUgS7XAPGtSunQl5q8Pl4,8316
51
51
  convoviz/models/node.py,sha256=1vBAtKVscYsUBDnKAOyLxuZaK9KoVF1dFXiKXRHxUnY,1946
52
- convoviz/pipeline.py,sha256=GIEsDV9Gr1LJdr5RulzkZoevxryP_SR4YOAb7XpwtSw,6328
52
+ convoviz/pipeline.py,sha256=ClOazQRiOnf4TKogoR1YLam1w7n4k6tznLrEOaB0u8M,6376
53
53
  convoviz/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
54
54
  convoviz/renderers/__init__.py,sha256=IQgwD9NqtUgbS9zwyPBNZbBIZcFrbZ9C7WMAV-X3Xdg,261
55
55
  convoviz/renderers/markdown.py,sha256=55PACkd-F0mmBXWXQ5SrfJr3UNrK_z2spQnePdk1UsQ,7849
56
56
  convoviz/renderers/yaml.py,sha256=XG1s4VhDdx-TiqekTkgED87RZ1lVQ7IwrbA-sZHrs7k,4056
57
57
  convoviz/utils.py,sha256=IQEKYHhWOnYxlr4GwAHoquG0BXTlVRkORL80oUSaIeQ,3417
58
- convoviz-0.3.1.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
59
- convoviz-0.3.1.dist-info/entry_points.txt,sha256=HYsmsw5vt36yYHB05uVU48AK2WLkcwshly7m7KKuZMY,54
60
- convoviz-0.3.1.dist-info/METADATA,sha256=0Botn_h6f6lZeHkRrfn8aiiTIhRVnMfbVGjwDDtoe2Y,5264
61
- convoviz-0.3.1.dist-info/RECORD,,
58
+ convoviz-0.3.3.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
59
+ convoviz-0.3.3.dist-info/entry_points.txt,sha256=HYsmsw5vt36yYHB05uVU48AK2WLkcwshly7m7KKuZMY,54
60
+ convoviz-0.3.3.dist-info/METADATA,sha256=2s1l6pgN3qQWeW1_5fvCcF--SIBWDaEI6v_D4uFxJSM,5077
61
+ convoviz-0.3.3.dist-info/RECORD,,