Skip to content

Commit 3865d53

Browse files
Revise README for clarity and conciseness
Updated application description and removed redundant sections. Streamlined feature list and improved formatting for clarity.
1 parent c8b375c commit 3865d53

1 file changed

Lines changed: 2 additions & 124 deletions

File tree

README.md

Lines changed: 2 additions & 124 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,6 @@
11
# CodebookAI
22

3-
CodebookAI is a powerful text classification application that leverages OpenAI's advanced language models to automatically categorize text snippets into predefined labels. The application supports both batch processing for large datasets and real-time processing for immediate results.
4-
5-
## Features
6-
7-
### 🚀 Batch Processing
8-
- **Efficient Large-Scale Processing**: Submit hundreds or thousands of text snippets for classification using OpenAI's batch API
9-
- **Cost-Effective**: Batch processing offers significant cost savings compared to individual API calls
10-
- **Background Processing**: Jobs run in the background with 24-hour completion windows
11-
- **Status Monitoring**: Track ongoing and completed batch jobs with real-time status updates
12-
- **Easy Result Export**: Download classification results as CSV files with confidence scores
13-
14-
### ⚡ Live Processing
15-
- **Real-Time Classification**: Process text snippets immediately using OpenAI's API
16-
- **Interactive Workflow**: Perfect for smaller datasets or when immediate results are needed
17-
- **Progress Tracking**: Monitor processing status for each text snippet
18-
19-
### 🛠 User-Friendly Interface
20-
- **Intuitive GUI**: Clean, modern interface built with tkinter
21-
- **Tabbed Organization**: Separate views for ongoing and completed batch jobs
22-
- **Context Menus**: Right-click actions for batch management (cancel, download, retry)
23-
- **Tooltips**: Helpful hover text explains button functions
24-
- **CSV Import**: Easy import of labels and text data from CSV files
25-
26-
### 🔐 Secure Configuration
27-
- **Secure API Key Storage**: API keys stored safely in your system's keyring (Windows Credential Manager, macOS Keychain, Linux Secret Service)
28-
- **Configurable Settings**: Customize AI model, batch limits, and timezone preferences
29-
- **No Hardcoded Secrets**: Sensitive data never stored in configuration files
3+
CodebookAI is a powerful text classification application that leverages OpenAI's language models to perform a variety of tasks - primarily to automatically categorize text snippets into predefined labels. The application supports both batch processing for large datasets and real-time processing for immediate results.
304

315
## Installation
326

@@ -131,13 +105,6 @@ text
131105
- **Download**: Right-click completed batches to save results
132106
- **Refresh**: Click refresh (↻) to update status information
133107

134-
### CSV Format Requirements
135-
136-
- **Headers**: First row can be headers (will be skipped automatically)
137-
- **Single Column**: Only the first column is used for data
138-
- **Text Format**: Ensure text is properly quoted if it contains commas
139-
- **Encoding**: UTF-8 encoding recommended
140-
141108
## Configuration
142109

143110
### Settings Options
@@ -147,99 +114,10 @@ text
147114
- **Max Batches**: Number of recent batches to display (default: 4)
148115
- **Timezone**: Timezone for displaying batch creation times
149116

150-
### Supported Models
151-
152-
CodebookAI works with OpenAI's latest models:
153-
- **o3** (default): Most capable reasoning model
154-
- **gpt-4o**: Fast and capable general model
155-
- **gpt-4**: Highly capable general model
156-
157-
## Output Format
158-
159-
Classification results are saved as CSV files with these columns:
160-
- **quote**: The original text that was classified
161-
- **label**: The assigned classification label
162-
- **confidence**: Confidence score (0.0 to 1.0)
163-
164-
Example output:
165-
```csv
166-
quote,label,confidence
167-
"This product is amazing!",Positive,0.95
168-
"I hate this service",Negative,0.92
169-
"It's okay, nothing special",Neutral,0.87
170-
```
171-
172-
## Troubleshooting
173-
174-
### Common Issues
175-
176-
**API Key Errors**:
177-
- Verify your API key is correct and has sufficient credits
178-
- Check that your key has access to the selected model
179-
180-
**CSV Import Problems**:
181-
- Ensure CSV files are properly formatted
182-
- Check file encoding (UTF-8 recommended)
183-
- Verify files aren't corrupted or locked by other applications
184-
185-
**Batch Processing Delays**:
186-
- Batch jobs can take up to 24 hours to complete
187-
- Large batches take longer than small ones
188-
- Check OpenAI's status page for service issues
189-
190-
**UI Freezing During Live Processing**:
191-
- This is expected behavior - live processing blocks the UI
192-
- Use batch processing for large datasets
193-
- Consider breaking large datasets into smaller chunks
194-
195-
### Getting Help
196-
197-
If you encounter issues:
198-
1. Check the application's error messages
199-
2. Verify your CSV file format
200-
3. Ensure your API key is valid and has credits
201-
4. Check your internet connection
202-
203-
## Privacy & Security
204-
205-
- **API Keys**: Stored securely in your system's native keyring
206-
- **Data**: Text data is sent to OpenAI for processing according to their privacy policy
207-
- **Local Storage**: No sensitive data stored in application files
208-
- **Network**: HTTPS connections used for all API communications
209-
210-
## Development
211-
212-
CodebookAI is built with:
213-
- **Python 3.9+**: Core application
214-
- **tkinter**: GUI framework
215-
- **OpenAI Python SDK**: API integration
216-
- **pandas**: Data manipulation
217-
- **keyring**: Secure credential storage
218-
219-
### Project Structure
220-
```
221-
CodebookAI/
222-
├── ui/ # User interface modules
223-
│ ├── main_window.py # Main application window
224-
│ └── settings_window.py # Settings configuration dialog
225-
├── batch_processing/ # Batch job management
226-
│ └── batch_method.py # OpenAI batch API integration
227-
├── live_processing/ # Real-time processing
228-
│ ├── live_method.py # Live processing workflow
229-
│ └── response_calls.py # API response handling
230-
├── file_handling/ # Data import/export
231-
│ ├── csv_handling.py # CSV file operations
232-
│ └── json_handling.py # JSON schema and batch files
233-
├── settings/ # Configuration management
234-
│ ├── config.py # Non-sensitive settings
235-
│ └── secrets_store.py # Secure credential storage
236-
└── requirements.txt # Python dependencies
237-
```
238-
239117
## License
240118

241119
This project is provided as-is for educational and research purposes. Please ensure compliance with OpenAI's usage policies when using this application.
242120

243121
---
244122

245-
**Note**: This application requires an OpenAI API key and will incur costs based on your usage. Batch processing typically offers significant cost savings compared to individual API calls. Please monitor your usage and costs through the OpenAI dashboard.
123+
**Note**: This application requires an OpenAI API key and will incur costs based on your usage. Batch processing typically offers significant cost savings compared to individual API calls. Please monitor your usage and costs through the OpenAI dashboard.

0 commit comments

Comments
 (0)