Installation Overview¶
Get Neuron Daily Newsletter Automation running on your system in just a few minutes. We support multiple installation methods to fit your preferences and technical comfort level.
Choose Your Installation Method¶
Best for: Most users, direct from source
- Always latest version from GitHub
- Complete system integration
- Built-in update functionality
- Works on all platforms
For non-technical users: We're developing easier installation methods
- One-click installers in development
- Desktop app versions planned
- Git Clone method currently most reliable
System Requirements¶
Before installing, ensure your system meets these minimum requirements:
Operating Systems¶
| Platform | Minimum Version | Recommended |
|---|---|---|
| Linux | Ubuntu 18.04+ / Debian 10+ | Ubuntu 22.04+ |
| macOS | macOS 10.14+ (Mojave) | macOS 12+ (Monterey) |
| Windows | Windows 10 | Windows 11 |
Software Dependencies¶
| Component | Minimum Version | Purpose |
|---|---|---|
| Python | 3.6+ | Runtime environment |
| Chrome | Latest stable | Browser automation |
| Internet | Broadband | Newsletter fetching |
Automatic Installation
Our installers will automatically install missing dependencies, including Python and Chrome if needed.
Installation Time¶
| Method | Time Required | Technical Level |
|---|---|---|
| pip install | 2-3 minutes | Beginner |
| Manual install | 5-10 minutes | Beginner |
What Gets Installed¶
The installation process sets up:
- Core automation scripts
- Configuration files
- Automatic scheduling (systemd/launchd/Task Scheduler)
- Virtual environment with dependencies
- Command-line tools (
neuron-automation,blacklist-rewind) - Log files and data directories
Post-Installation¶
After installation, you can:
- Test the system:
neuron-automation - Check version:
neuron-automation --version - View statistics:
neuron-automation --stats - Configure settings: Edit
~/.config/neuron-automation/config.py
Need Help?¶
If you run into issues during installation:
- Check our Troubleshooting Guide
- Report bugs on GitHub Issues
- Read the Configuration Guide for customization options
Ready to get started? Choose your preferred installation method above!
Neuron Daily Newsletter Automation¶
Why This Exists: Reading the Neuron Daily newsletter is a great way to start the day, but manually clicking through all the article links takes time. This automation opens everything at once, so you can spend your morning reading instead of clicking. Built collaboratively with Claude AI to solve a real daily workflow need.
If this saves you time too, give it a ⭐ and let us know how it works for you!
Cross-platform automation system that automatically opens the latest Neuron Daily newsletter with all article links in separate tabs every weekday morning.
Supported Platforms: Linux, macOS, Windows