Ultra-Powerful Personal AI Agent with Multi-Device Control, 100+ LLM Provider support via litellm, and 30+ tools
Project description
SwiftNode V5 ⚡
An autonomous, pip-installable AI personal agent powered by Litellm (100+ providers), with interactive terminal chat, Discord/Telegram/WhatsApp integration, multi-device control, long-term RAG memory, and 30+ powerful tools.
Features • Installation • Quick Start • CLI Commands • Contributing
📖 Overview
SwiftNode V5 is a cutting-edge personal computing intelligence framework. It acts as your localized AI assistant capable of automating your daily workflow across multiple devices. Powered by litellm, it seamlessly integrates with 100+ AI providers. SwiftNode scales from a simple CLI terminal chat to a comprehensive multi-node automation network.
Topics/Tags: ai-agent automation llm multi-device telegram-bot discord-bot whatsapp-bot rag python termux
🚀 Features
| Category | Capabilities |
|---|---|
| 🧠 AI Engine | Powered by litellm — supports 100+ providers (OpenAI, Anthropic, Gemini, Groq, DeepSeek, local models, etc.) |
| 💬 Terminal Chat | Interactive, rich terminal chat mode directly from CLI without needing a bot platform. |
| 🤖 Bot Integrations | Seamless connections with Telegram, Discord, and WhatsApp (Selenium QR Auth). |
| 🌐 Web Research | DuckDuckGo search, URL fetch, Wikipedia, Top News, YouTube transcript extraction. |
| 💻 System Control | CPU/RAM/Disk polling, Screenshots, Subprocess management, Process termination. |
| 📦 Files & Folders | Read/write files, Desktop push notifications, file zipping and management. |
| 🌍 Network Tasks | Public IP retrieval, ICMP Ping, LAN device scanner, Bandwidth speed tests, real-time Weather. |
| 🐍 Code & Math | Secure execution of Python snippets, automated Linting, safe Math evaluation, Base64 encode/decode, hashing. |
| 📱 Android / Termux | Native support for Android (Termux) + ADB control (Tap, Swipe, Type, APK Install, Screenshots, Screen Recording). |
| 💾 Persistent Memory | Long-term RAG vector memory backed by Google Embeddings and SQLite. |
| 🔗 Multi-Device Grid | HTTP API to control any connected worker node across your Local Area Network. |
📦 Installation
Prerequisites
- Python 3.9+
- For Windows/macOS/Linux standard installation
- For Android: Install Termux
Install via pip (Recommended)
pip install swiftnode
Install via Source (Development)
git clone https://github.com/ashik2770/SwiftNode.git
cd SwiftNode
pip install -e .
Install on Termux (Android)
git clone https://github.com/ashik2770/SwiftNode.git
cd SwiftNode
./install.sh
⚡ Quick Start
1. Initial Configuration
Run the automated setup wizard to link your preferred LLM Provider (via litellm), configure your bot platform, and set up your multi-device network.
swiftnode config
2. Start Your Agent
# Start an interactive terminal chat (No bot setup required!)
swiftnode chat
# Start the messaging bot (Telegram/Discord/WhatsApp configured in setup)
swiftnode run
# Explicitly start a specific bot platform
swiftnode run --bot telegram
swiftnode run --bot discord
🖥️ CLI Commands
| Command | Description |
|---|---|
swiftnode chat |
💬 Start interactive terminal chat session |
swiftnode run |
🚀 Start the default messaging bot |
swiftnode run --bot <name> |
🌐 Start a specific bot (telegram/discord/whatsapp) |
swiftnode config |
⚙️ Setup or reconfigure your environment |
swiftnode serve |
🌐 Start multi-device HTTP server node |
swiftnode connect <ip> |
📡 Connect to a remote SwiftNode master device |
swiftnode tools |
🔧 List all active context tools |
swiftnode update |
🔄 Update SwiftNode via pip |
swiftnode version |
ℹ️ Show version and system diagnostics |
🌐 Multi-Device Control Architecture
Control multiple physical devices from a central brain. Works on PC, Termux (Android), Raspberry Pi, and macOS.
1. Launch the Server Node (Master/Worker)
swiftnode serve
# Starts a secure HTTP API on port 7799
2. Form the Grid (Client)
swiftnode connect 192.168.1.100
# Connects directly to the remote agent
🤝 Contributing
We welcome contributions! Please review our Contribution Guidelines before submitting pull requests.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
📝 License
Distributed under the MIT License. See LICENSE for more information.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file swiftnode-5.0.0.tar.gz.
File metadata
- Download URL: swiftnode-5.0.0.tar.gz
- Upload date:
- Size: 45.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d473c022a447a5e1d0923c9073b18923a501c300cb1bf7aeb5544bccd73542c5
|
|
| MD5 |
ebd4f5daf35535bb75636e618f14a7a4
|
|
| BLAKE2b-256 |
0ce507e4eeb9853e02949db5d8404174e1904272807f6b64f1d135af14700b7c
|
File details
Details for the file swiftnode-5.0.0-py3-none-any.whl.
File metadata
- Download URL: swiftnode-5.0.0-py3-none-any.whl
- Upload date:
- Size: 50.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cf17a684c7e00b9bc1b391f42f388ef8d4318d24954d7747c56e23c8f62cb2f4
|
|
| MD5 |
ccd5e72887152e2f985cc8d22d6e0b75
|
|
| BLAKE2b-256 |
24bb7410da7324a93813397bac1995184113b0cf5cfc783953bd5cc32e3a35d2
|