You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
30
4
31
5
## Installation
32
6
@@ -131,13 +105,6 @@ text
131
105
-**Download**: Right-click completed batches to save results
132
106
-**Refresh**: Click refresh (↻) to update status information
133
107
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
-
141
108
## Configuration
142
109
143
110
### Settings Options
@@ -147,99 +114,10 @@ text
147
114
-**Max Batches**: Number of recent batches to display (default: 4)
148
115
-**Timezone**: Timezone for displaying batch creation times
149
116
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
This project is provided as-is for educational and research purposes. Please ensure compliance with OpenAI's usage policies when using this application.
242
120
243
121
---
244
122
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