Imagine having a personal assistant that not only understands your commands but seamlessly integrates with your digital life. Meet VORTEX, an intelligent desktop assistant that combines voice interaction, smart automation, and natural conversation capabilities. While there are many virtual assistants available, VORTEX stands out by offering a unique blend of offline functionality and cloud-powered intelligence.
LUNA represents the future of desktop interaction - a future where your computer truly understands you. While we're still in beta and working through some challenges, we're committed to creating the most intuitive and powerful desktop assistant available.
- Native desktop application control
- File and application management
- System commands execution
- Custom shortcut management
- WhatsApp integration for messages and calls
- Contact management system
- Smart contact recognition
- YouTube voice commands
- Media playback control
- Browser integration
- Powered by Google's Gemini AI
- Natural language processing
- Contextual responses
- Learning capabilities
- Modern UI built with HTML5, CSS3, and JavaScript
- Real-time voice visualization
- Responsive chat interface
- Cross-platform compatibility
- Python core engine
- SQLite database for local storage
- Speech recognition system
- API integrations (YouTube, WhatsApp, Gemini)
- Beta testing stage
- Core functionality implemented
- Basic error handling in place
- Occasional speech recognition errors
- Limited to Windows OS currently
- Internet required for some features
- May experience latency in responses
- Enhanced error handling
- Expanded command database
- Offline mode for basic functions
- Performance optimization
- Mobile app development
- Cross-platform support
- Custom voice training
- Advanced automation features
- Cloud sync capabilities
-
Privacy-Focused
- Local processing when possible
- No constant cloud connectivity required
- User data stays on device
-
Customizable
- User-defined commands
- Adaptable to user preferences
- Extensible architecture
-
Integration-Ready
- Works with existing applications
- No ecosystem lock-in
- Open architecture for developers
-
Desktop-First
- Optimized for computer use
- Deep system integration
- Professional workflow focus
- Professionals seeking productivity tools
- Tech-savvy individuals
- Students and educators
- Small business owners
- Desktop power users
Prerequisites:
- Python 3.12+
- uv (modern Python package manager)
Setup & Run:
- Clone the repository
git clone https://github.com/dev-Ninjaa/Vortex-AI.git cd LUNA-AI - Initialize the project (if not already present)
uv init
- Import dependencies (if migrating from requirements.txt)
uv add -r requirements.txt -c requirements.txt
- Sync the environment
uv sync
- Set up environment variables
- Create a
.envfile in the root directory - Add your Gemini API key:
GOOGLE_API_KEY=your_api_key_here
- Create a
- Run the assistant:
uv run python run.py
- Backend:
- Add new Python modules in the
Backend/directory. - Import and use them in
main.pyorrun.pyas needed.
- Add new Python modules in the
- Frontend:
- Add new JS/CSS modules in the
Frontend/directory. - Reference them in
index.htmlor other HTML files.
- Add new JS/CSS modules in the
- Dependencies:
- Add new dependencies with:
uv add <package>
- Sync your environment after changes:
uv sync
- Add new dependencies with:
- Install dependencies:
uv sync
- Add new dependencies:
uv add <package>
- Run the app:
uv run python run.py
- Use
.envfor secrets and API keys. - Keep
uv.lockcommitted for reproducible environments. - Do not commit
database.dbor.venv/(see.gitignore).
Current Version: Beta 1.0
- Core functionality implemented
- Active development ongoing
- Community feedback integration
- Regular updates and improvements
Known Issues:
- Speech recognition may require multiple attempts
- Some commands may not work consistently
- Response times can vary
- Limited error recovery in some scenarios
We're transparent about these limitations as we believe in honest communication with our users. Each update brings improvements and new features based on user feedback.
Why users might choose VORTEX over alternatives:
-
Desktop Focus
- Unlike mobile-first assistants, VORTEX is optimized for computer use
- Better integration with desktop workflows
- More powerful system control capabilities
-
Privacy
- Local processing where possible
- No always-on microphone
- Transparent data handling
-
Customization
- User-defined commands and shortcuts
- Adaptable to specific needs
- Open architecture
-
Community
- Active development
- User feedback integration
- Regular updates
-
Cost
- Free during beta
- Planned affordable pricing
- No expensive hardware required
Q: How is VORTEX different from Alexa or Google Assistant?
A: VORTEX is designed specifically for desktop environments with deep system integration. Unlike cloud-only assistants, VORTEX can perform offline tasks and directly control your computer.
Q: What happens if the internet connection fails?
A: VORTEX maintains basic functionality offline, including system commands and application control. Only cloud-dependent features like AI chat and YouTube require internet.
Q: Is my data secure?
A: Yes. VORTEX processes most commands locally and only sends data to the cloud when necessary (like for AI responses). No personal data is stored on external servers.
Q: Will VORTEX work on my Mac/Linux system?
A: Currently, VORTEX is Windows-only, but cross-platform support is a key priority in our roadmap.
Q: How much does it cost?
A: VORTEX is currently free during the beta phase. Future pricing will include both free and premium tiers with advanced features.
We welcome contributions from the community! If you'd like to contribute to VORTEX, please follow these steps:
- Fork the repository
- Create a new branch (
git checkout -b feature/AmazingFeature) - Make your changes
- Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
LUNA - Redefining desktop interaction, one command at a time.