convoviz 0.4.3__py3-none-any.whl → 0.4.5__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.
convoviz/interactive.py CHANGED
@@ -92,7 +92,7 @@ def run_interactive_config(initial_config: ConvovizConfig | None = None) -> Conv
92
92
  input_default = str(config.input_path) if config.input_path else ""
93
93
  input_result: str = _ask_or_cancel(
94
94
  qst_path(
95
- "Enter the path to the export ZIP, conversations JSON, or extracted directory:",
95
+ "Enter the path to the export ZIP:", # , conversations JSON, or extracted directory:",
96
96
  default=input_default,
97
97
  validate=_validate_input_path,
98
98
  style=CUSTOM_STYLE,
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: convoviz
3
- Version: 0.4.3
4
- Summary: Get analytics and visualizations on your ChatGPT data!
3
+ Version: 0.4.5
4
+ Summary: Convert your ChatGPT export (ZIP) into clean Markdown text files with inline media, and generate data visualizations like word clouds and usage graphs.
5
5
  Keywords: markdown,chatgpt,openai,visualization,analytics,json,export,data-analysis,obsidian
6
6
  Author: Mohamed Cheikh Sidiya
7
7
  Author-email: Mohamed Cheikh Sidiya <mohamedcheikhsidiya77@gmail.com>
@@ -27,7 +27,12 @@ Description-Content-Type: text/markdown
27
27
  <h1 align="center">Convoviz 📊</h1>
28
28
  <p align="center"><strong>Visualize your entire ChatGPT data</strong></p>
29
29
  <p align="center">
30
- Convert your ChatGPT history into well-formatted Markdown files.<br>
30
+ Convert your ChatGPT history into clean, readable Markdown (text files).
31
+ </p>
32
+ <p align="center"><strong>
33
+ Perfect for archiving, local search, or use with note-taking apps like Obsidian.
34
+ </strong></p>
35
+ <p align="center">
31
36
  Visualize your data with word clouds 🔡☁️ and usage graphs 📈.
32
37
  </p>
33
38
  </p>
@@ -67,25 +72,29 @@ Description-Content-Type: text/markdown
67
72
 
68
73
  ### Step 2: Install Convoviz
69
74
 
70
- <details open>
71
- <summary><strong>🚀 Quick Install (Recommended)</strong></summary>
75
+ ### 🚀 Quick Install
72
76
 
73
- One command installs everything you need [uv](https://github.com/astral-sh/uv) (a fast Python package manager) and convoviz with graphs and word clouds.
77
+ Run one of the commands below to install **everything** you need automatically.
74
78
 
75
- **Linux / macOS:**
79
+ #### 🍎 macOS / 🐧 Linux
80
+ 1. Open `Terminal`.
81
+ - **macOS**: Press `Cmd + Space`, type "Terminal", and hit Enter.
82
+ - **Linux**: Press `Ctrl + Alt + T`, or search "Terminal" in your app menu.
83
+ 2. Copy and paste this command:
76
84
 
77
85
  ```bash
78
86
  curl -fsSL https://raw.githubusercontent.com/mohamed-chs/convoviz/main/install.sh | bash
79
87
  ```
80
88
 
81
- **Windows (PowerShell):**
89
+ #### 🪟 Windows
90
+ 1. Open `PowerShell`.
91
+ - Press the `Windows` key, type "PowerShell", and hit Enter.
92
+ 2. Copy and paste this command:
82
93
 
83
94
  ```powershell
84
95
  irm https://raw.githubusercontent.com/mohamed-chs/convoviz/main/install.ps1 | iex
85
96
  ```
86
97
 
87
- </details>
88
-
89
98
  <details>
90
99
  <summary><strong>📦 Alternative: Install with pip</strong></summary>
91
100
 
@@ -108,7 +117,7 @@ pip install "convoviz[viz]"
108
117
 
109
118
  ### Step 3: Run Convoviz
110
119
 
111
- The simplest way is to run the command and follow the interactive prompts:
120
+ The simplest way is to run this in your terminal and follow the interactive prompts:
112
121
 
113
122
  ```bash
114
123
  convoviz
@@ -157,7 +166,7 @@ convoviz --help
157
166
 
158
167
  ### Step 4: Check the Output 🎉
159
168
 
160
- After running the script, head to your output folder to see:
169
+ After running the script, head to your output folder (defaults to `Documents/ChatGPT-Data` if you didn't change it) to see:
161
170
  - 📝 Neatly formatted Markdown files
162
171
  - 📊 Visualizations and graphs
163
172
 
@@ -185,6 +194,19 @@ Interested in contributing? Check out the **[Contributing Guide](https://github.
185
194
 
186
195
  ## 📝 Notes
187
196
 
197
+ <details>
198
+ <summary><strong>Offline</strong></summary>
199
+
200
+ Word clouds use NLTK stopwords. If you're offline and NLTK data isn't installed yet, pre-download it:
201
+
202
+ ```bash
203
+ python -c "import nltk; nltk.download('stopwords')"
204
+ ```
205
+
206
+ **NOTE:** The install script already handles this, so you can immediately go offline after running it.
207
+
208
+ </details>
209
+
188
210
  <details>
189
211
  <summary><strong>About This Project</strong></summary>
190
212
 
@@ -203,17 +225,6 @@ It should also work as a library, so you can import and use the models and funct
203
225
 
204
226
  </details>
205
227
 
206
- <details>
207
- <summary><strong>Offline / Reproducible Runs</strong></summary>
208
-
209
- Word clouds use NLTK stopwords. If you're offline and NLTK data isn't installed yet, pre-download it:
210
-
211
- ```bash
212
- python -c "import nltk; nltk.download('stopwords')"
213
- ```
214
-
215
- </details>
216
-
217
228
  <details>
218
229
  <summary><strong>Bookmarklet (Experimental)</strong></summary>
219
230
 
@@ -39,7 +39,7 @@ convoviz/assets/stopwords.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs
39
39
  convoviz/cli.py,sha256=nniH7QPbbH_buQJGa35vd3IEl7RvZsWRiLpUuhlxXaI,5314
40
40
  convoviz/config.py,sha256=qo4JPkJRx1UgvVN_x-XmycxdjU9XwPlqoZWJLsDMSAs,3592
41
41
  convoviz/exceptions.py,sha256=bQpIKls48uOQpagEJAxpXf5LF7QoagRRfbD0MjWC7Ak,1476
42
- convoviz/interactive.py,sha256=Xq55VJJ4OQ9NlY4nlb2NRLzxmA5-ot521N8tGqyPix4,8691
42
+ convoviz/interactive.py,sha256=EckJqVKmqvqXOrnEg-q59F5y5F-0mePJhfAngmf2qpQ,8698
43
43
  convoviz/io/__init__.py,sha256=y70TYypJ36_kaEA04E2wa1EDaKQVjprKItoKR6MMs4M,471
44
44
  convoviz/io/assets.py,sha256=5zcZPlQa9niDw9o-sqJIKgLc0OJ9auzd6KAve5WfBkQ,3459
45
45
  convoviz/io/loaders.py,sha256=SqmBWUBqT5lsCf01yy-FUhwIxbiKTFMQnj4k213DsGI,5891
@@ -56,7 +56,7 @@ convoviz/renderers/__init__.py,sha256=IQgwD9NqtUgbS9zwyPBNZbBIZcFrbZ9C7WMAV-X3Xd
56
56
  convoviz/renderers/markdown.py,sha256=55PACkd-F0mmBXWXQ5SrfJr3UNrK_z2spQnePdk1UsQ,7849
57
57
  convoviz/renderers/yaml.py,sha256=XG1s4VhDdx-TiqekTkgED87RZ1lVQ7IwrbA-sZHrs7k,4056
58
58
  convoviz/utils.py,sha256=IQEKYHhWOnYxlr4GwAHoquG0BXTlVRkORL80oUSaIeQ,3417
59
- convoviz-0.4.3.dist-info/WHEEL,sha256=fAguSjoiATBe7TNBkJwOjyL1Tt4wwiaQGtNtjRPNMQA,80
60
- convoviz-0.4.3.dist-info/entry_points.txt,sha256=HYsmsw5vt36yYHB05uVU48AK2WLkcwshly7m7KKuZMY,54
61
- convoviz-0.4.3.dist-info/METADATA,sha256=ymsURng5-kO-OhKy7VwWTuYqtcW7Z7_sOedQhYFxH6g,7301
62
- convoviz-0.4.3.dist-info/RECORD,,
59
+ convoviz-0.4.5.dist-info/WHEEL,sha256=fAguSjoiATBe7TNBkJwOjyL1Tt4wwiaQGtNtjRPNMQA,80
60
+ convoviz-0.4.5.dist-info/entry_points.txt,sha256=HYsmsw5vt36yYHB05uVU48AK2WLkcwshly7m7KKuZMY,54
61
+ convoviz-0.4.5.dist-info/METADATA,sha256=cq_PkqxhP9IOFEwVviir16PypsCGyJUlUXLogBg6s6U,7887
62
+ convoviz-0.4.5.dist-info/RECORD,,