Alithia is a Chrome extension that helps users avoid potential consequences by scanning content before posting. Using advanced AI analysis, it provides instant warnings about possible outcomes of posting specific content, allowing users to make more informed decisions online.
- Content Analysis: Scans both text and images on the current page
- Real-time Warnings: Provides instant feedback about potential consequences
- User-friendly Interface: Simple one-click operation
- Privacy-focused: All analysis happens via secure API - no data storage
Alithia before and after prediction
BETA NOTICE: Alithia is currently in beta and requires manual installation and configuration.
- Download or clone this repository
- Important: You need to update the API key in
app/popup.js:- Open
app/popup.jsin a text editor - Find the
apiKeyvariable (around line 37) - Replace it with your own OpenAI API key
- Open
- Open Chrome and navigate to
chrome://extensions/ - Enable "Developer mode" in the top-right corner
- Click "Load unpacked" and select the extension directory
- The Alithia icon should appear in your browser toolbar
- Visit OpenAI's platform
- Create or log into your account
- Navigate to the API keys section
- Generate a new API key
- Copy and paste this key into the
popup.jsfile
- Navigate to any webpage where you're considering posting content
- Click the Alithia icon in your browser toolbar
- Click the "Scan Content" button
- Review the warning about potential consequences
- Make an informed decision about whether to post
Alithia works by:
- Extracting text and counting images from the current page
- Sending this information to OpenAI's GPT-4o model
- Processing the AI's analysis to generate a concise warning
- Displaying the result to the user
- Alithia only accesses page content when you explicitly click the scan button
- No data is stored locally or remotely beyond the immediate analysis
- API calls are made securely with proper authentication
- Chrome based browser
- Basic knowledge of JavaScript, HTML, and CSS
├── app/
│ ├── background.js # Background service worker
│ ├── popup.html # Extension popup interface
│ ├── popup.js # Popup functionality
│ ├── styles.css # Styling for popup.html
│ └── icons/ # Extension icons
├── media/ # Screenshots and GIFs for README gallery
├── manifest.json # Extension configuration
├── LICENSE # MIT License
└── README.md # This file
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- API Key Security: The current implementation requires storing your API key directly in the code. This is not recommended for production use.
- API Usage Costs: Be aware that using the OpenAI API will incur costs based on your usage.
- Limited Content Detection: The extension currently only scans visible text and counts images on the page.
- "Error processing content": Verify your API key is correctly entered and has sufficient credits
- No popup appears: Make sure the extension is properly installed and has the required permissions
- Slow response times: This could be due to API latency or issues with your internet connection
- More secure API key handling
- Firefox port
- Published version on the Chrome & Firefox Web Store
- Always Free, donation based version.
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with OpenAI's GPT-4o API
- Icon created using Krita
Note: Always review and adhere to the terms of service for any platform where you're posting content. Alithia is meant as a helpful tool, not as a guarantee against all possible consequences of online actions.

