aichat2md 1.0.0__tar.gz

aichat2md-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PlaceNameDay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aichat2md-1.0.0/PKG-INFO

@@ -0,0 +1,288 @@
+Metadata-Version: 2.4
+Name: aichat2md
+Version: 1.0.0
+Summary: Convert AI chat conversations to structured Markdown
+Author: PlaceNameDay
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/aichat2md
+Project-URL: Repository, https://github.com/yourusername/aichat2md
+Project-URL: Issues, https://github.com/yourusername/aichat2md/issues
+Keywords: chatgpt,claude,markdown,ai,converter,deepseek
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: requests>=2.31.0
+Dynamic: license-file
+
+# aichat2md
+
+Convert AI chat conversations to structured Markdown documents.
+
+## Features
+
+- 🌐 **Extract from URLs** - ChatGPT share links (with JS rendering via Playwright)
+- 📄 **Extract from webarchive** - Safari .webarchive files (offline mode)
+- 🤖 **Multiple AI backends** - DeepSeek, OpenAI, Groq, or any OpenAI-compatible API
+- 🌍 **Bilingual support** - English/Chinese prompts
+- 📝 **Clean output** - Knowledge-focused Markdown, not chat logs
+- ⚡ **Simple CLI** - pip-installable, one-time setup
+
+## Quick Start
+
+```bash
+# Install
+pip install aichat2md
+
+# Configure (one-time setup)
+aichat2md --setup
+
+# Convert a ChatGPT share URL
+aichat2md https://chatgpt.com/share/xxx
+
+# Convert a webarchive file
+aichat2md ~/Downloads/chat.webarchive
+```
+
+## Supported AI Backends
+
+- **DeepSeek** (default) - Cost-effective, Chinese service
+- **OpenAI** - GPT-4o-mini, GPT-4
+- **Groq** - Fast inference with Llama models
+- **Custom** - Any OpenAI-compatible API
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8 or higher
+- Playwright (automatically installed, but requires browser setup)
+
+### Install from PyPI
+
+```bash
+pip install aichat2md
+```
+
+### Install Playwright browsers
+
+```bash
+playwright install chromium
+```
+
+### First-time Setup
+
+```bash
+aichat2md --setup
+```
+
+You'll be prompted to:
+1. Select your AI provider (DeepSeek, OpenAI, Groq, or custom)
+2. Enter your API key
+3. Choose prompt language (English or Chinese)
+4. Set output directory (default: ~/Downloads)
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Convert from URL (uses configured output directory)
+aichat2md https://chatgpt.com/share/xxx
+
+# Convert from webarchive (outputs to same directory as input)
+aichat2md ~/Downloads/chat.webarchive
+```
+
+### Override Language
+
+```bash
+# Use Chinese prompts (even if English is configured)
+aichat2md <url> --lang zh
+
+# Use English prompts
+aichat2md <url> --lang en
+```
+
+### Custom Output Path
+
+```bash
+# Specify output file
+aichat2md <url> -o ~/Documents/my-notes.md
+aichat2md <url> --output ~/Documents/my-notes.md
+```
+
+### Override Model
+
+```bash
+# Use a different model than configured
+aichat2md <url> --model gpt-4o
+aichat2md <url> --model deepseek-chat
+```
+
+### Version Info
+
+```bash
+aichat2md --version
+```
+
+## Configuration
+
+Configuration is stored in `~/.config/aichat2md/config.json` (cross-platform).
+
+### Example Config
+
+```json
+{
+  "api_key": "sk-your-api-key",
+  "api_base_url": "https://api.deepseek.com",
+  "model": "deepseek-chat",
+  "language": "en",
+  "output_dir": "/Users/you/Downloads",
+  "max_tokens": 4000,
+  "temperature": 0.7
+}
+```
+
+### Reconfigure
+
+```bash
+aichat2md --setup
+```
+
+## Output Format
+
+The tool converts chat conversations into structured Markdown with:
+
+- **Front matter** - Tags, date, source
+- **Summary** - 2-3 sentence overview
+- **Key topics** - Bullet point list
+- **Knowledge sections** - Reorganized content with logical headings
+- **Code examples** - Extracted code blocks with comments
+
+### Example Output
+
+```markdown
+---
+tags: [Python, API, Web]
+date: 2026-02-02
+source: https://chatgpt.com/share/xxx
+---
+
+# Building REST APIs with FastAPI
+
+## Summary
+This document covers building production-ready REST APIs using FastAPI...
+
+## Key Topics
+- API design patterns
+- Request validation
+- Error handling
+
+## API Design Principles
+...
+
+## Code Examples
+\```python
+from fastapi import FastAPI
+app = FastAPI()
+...
+\```
+```
+
+## How It Works
+
+1. **Extract** - Playwright (URLs) or plistlib (webarchive) extracts raw text
+2. **Structurize** - AI API reorganizes into knowledge document
+3. **Save** - Auto-generated filename or specified path
+
+### Why Two-Stage Processing?
+
+- **Stage 1 (Extract)** - No AI tokens used, just HTML parsing
+- **Stage 2 (Structurize)** - AI organizes content efficiently
+
+This saves costs and allows local caching of extracted content.
+
+## Development
+
+### Local Installation
+
+```bash
+# Clone repository
+git clone https://github.com/yourusername/aichat2md.git
+cd aichat2md
+
+# Install in editable mode
+pip install -e .
+
+# Install Playwright
+playwright install chromium
+```
+
+### Run Tests
+
+```bash
+pip install pytest
+pytest tests/
+```
+
+### Build Package
+
+```bash
+pip install build
+python -m build
+```
+
+## Troubleshooting
+
+### "Configuration file not found"
+
+Run `aichat2md --setup` to create configuration.
+
+### "API authentication failed"
+
+Check your API key in `~/.config/aichat2md/config.json`.
+
+### Playwright errors
+
+Install browsers: `playwright install chromium`
+
+### Empty output
+
+The conversation might be too short or the AI response failed. Check error messages.
+
+## Contributing
+
+Contributions welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new features
+4. Submit a pull request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file.
+
+## Links
+
+- [GitHub Repository](https://github.com/yourusername/aichat2md)
+- [Issue Tracker](https://github.com/yourusername/aichat2md/issues)
+- [中文文档](README_zh.md)
+
+## Acknowledgments
+
+- [Playwright](https://playwright.dev/) - Web automation
+- [DeepSeek](https://www.deepseek.com/) - Cost-effective AI API
+- [OpenAI](https://openai.com/) - API compatibility standard

aichat2md-1.0.0/README.md

@@ -0,0 +1,260 @@
+# aichat2md
+
+Convert AI chat conversations to structured Markdown documents.
+
+## Features
+
+- 🌐 **Extract from URLs** - ChatGPT share links (with JS rendering via Playwright)
+- 📄 **Extract from webarchive** - Safari .webarchive files (offline mode)
+- 🤖 **Multiple AI backends** - DeepSeek, OpenAI, Groq, or any OpenAI-compatible API
+- 🌍 **Bilingual support** - English/Chinese prompts
+- 📝 **Clean output** - Knowledge-focused Markdown, not chat logs
+- ⚡ **Simple CLI** - pip-installable, one-time setup
+
+## Quick Start
+
+```bash
+# Install
+pip install aichat2md
+
+# Configure (one-time setup)
+aichat2md --setup
+
+# Convert a ChatGPT share URL
+aichat2md https://chatgpt.com/share/xxx
+
+# Convert a webarchive file
+aichat2md ~/Downloads/chat.webarchive
+```
+
+## Supported AI Backends
+
+- **DeepSeek** (default) - Cost-effective, Chinese service
+- **OpenAI** - GPT-4o-mini, GPT-4
+- **Groq** - Fast inference with Llama models
+- **Custom** - Any OpenAI-compatible API
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8 or higher
+- Playwright (automatically installed, but requires browser setup)
+
+### Install from PyPI
+
+```bash
+pip install aichat2md
+```
+
+### Install Playwright browsers
+
+```bash
+playwright install chromium
+```
+
+### First-time Setup
+
+```bash
+aichat2md --setup
+```
+
+You'll be prompted to:
+1. Select your AI provider (DeepSeek, OpenAI, Groq, or custom)
+2. Enter your API key
+3. Choose prompt language (English or Chinese)
+4. Set output directory (default: ~/Downloads)
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Convert from URL (uses configured output directory)
+aichat2md https://chatgpt.com/share/xxx
+
+# Convert from webarchive (outputs to same directory as input)
+aichat2md ~/Downloads/chat.webarchive
+```
+
+### Override Language
+
+```bash
+# Use Chinese prompts (even if English is configured)
+aichat2md <url> --lang zh
+
+# Use English prompts
+aichat2md <url> --lang en
+```
+
+### Custom Output Path
+
+```bash
+# Specify output file
+aichat2md <url> -o ~/Documents/my-notes.md
+aichat2md <url> --output ~/Documents/my-notes.md
+```
+
+### Override Model
+
+```bash
+# Use a different model than configured
+aichat2md <url> --model gpt-4o
+aichat2md <url> --model deepseek-chat
+```
+
+### Version Info
+
+```bash
+aichat2md --version
+```
+
+## Configuration
+
+Configuration is stored in `~/.config/aichat2md/config.json` (cross-platform).
+
+### Example Config
+
+```json
+{
+  "api_key": "sk-your-api-key",
+  "api_base_url": "https://api.deepseek.com",
+  "model": "deepseek-chat",
+  "language": "en",
+  "output_dir": "/Users/you/Downloads",
+  "max_tokens": 4000,
+  "temperature": 0.7
+}
+```
+
+### Reconfigure
+
+```bash
+aichat2md --setup
+```
+
+## Output Format
+
+The tool converts chat conversations into structured Markdown with:
+
+- **Front matter** - Tags, date, source
+- **Summary** - 2-3 sentence overview
+- **Key topics** - Bullet point list
+- **Knowledge sections** - Reorganized content with logical headings
+- **Code examples** - Extracted code blocks with comments
+
+### Example Output
+
+```markdown
+---
+tags: [Python, API, Web]
+date: 2026-02-02
+source: https://chatgpt.com/share/xxx
+---
+
+# Building REST APIs with FastAPI
+
+## Summary
+This document covers building production-ready REST APIs using FastAPI...
+
+## Key Topics
+- API design patterns
+- Request validation
+- Error handling
+
+## API Design Principles
+...
+
+## Code Examples
+\```python
+from fastapi import FastAPI
+app = FastAPI()
+...
+\```
+```
+
+## How It Works
+
+1. **Extract** - Playwright (URLs) or plistlib (webarchive) extracts raw text
+2. **Structurize** - AI API reorganizes into knowledge document
+3. **Save** - Auto-generated filename or specified path
+
+### Why Two-Stage Processing?
+
+- **Stage 1 (Extract)** - No AI tokens used, just HTML parsing
+- **Stage 2 (Structurize)** - AI organizes content efficiently
+
+This saves costs and allows local caching of extracted content.
+
+## Development
+
+### Local Installation
+
+```bash
+# Clone repository
+git clone https://github.com/yourusername/aichat2md.git
+cd aichat2md
+
+# Install in editable mode
+pip install -e .
+
+# Install Playwright
+playwright install chromium
+```
+
+### Run Tests
+
+```bash
+pip install pytest
+pytest tests/
+```
+
+### Build Package
+
+```bash
+pip install build
+python -m build
+```
+
+## Troubleshooting
+
+### "Configuration file not found"
+
+Run `aichat2md --setup` to create configuration.
+
+### "API authentication failed"
+
+Check your API key in `~/.config/aichat2md/config.json`.
+
+### Playwright errors
+
+Install browsers: `playwright install chromium`
+
+### Empty output
+
+The conversation might be too short or the AI response failed. Check error messages.
+
+## Contributing
+
+Contributions welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new features
+4. Submit a pull request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file.
+
+## Links
+
+- [GitHub Repository](https://github.com/yourusername/aichat2md)
+- [Issue Tracker](https://github.com/yourusername/aichat2md/issues)
+- [中文文档](README_zh.md)
+
+## Acknowledgments
+
+- [Playwright](https://playwright.dev/) - Web automation
+- [DeepSeek](https://www.deepseek.com/) - Cost-effective AI API
+- [OpenAI](https://openai.com/) - API compatibility standard

aichat2md-1.0.0/aichat2md/__init__.py

@@ -0,0 +1,5 @@
+"""aichat2md - Convert AI chat conversations to structured Markdown."""
+
+__version__ = "1.0.0"
+__author__ = "PlaceNameDay"
+__description__ = "Convert AI chat conversations to structured Markdown"