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.
Metadata
Release files for swiftnode 5.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| swiftnode-5.0.0.tar.gz | 45.1 kB | Without provenance | Details for swiftnode-5.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| swiftnode-5.0.0-py3-none-any.whl | Python 3 | none | any | Details for swiftnode-5.0.0-py3-none-any.whl |
Total release size: 95.8 kB
Release files / swiftnode-5.0.0.tar.gz
| Download URL | swiftnode-5.0.0.tar.gz |
|---|---|
| Size | 45.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d473c022a447a5e1d0923c9073b18923a501c300cb1bf7aeb5544bccd73542c5
|
|
BLAKE2b-256 checksum How to use checksums |
0ce507e4eeb9853e02949db5d8404174e1904272807f6b64f1d135af14700b7c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
Release files / swiftnode-5.0.0-py3-none-any.whl
| Download URL | swiftnode-5.0.0-py3-none-any.whl |
|---|---|
| Size | 50.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cf17a684c7e00b9bc1b391f42f388ef8d4318d24954d7747c56e23c8f62cb2f4
|
|
BLAKE2b-256 checksum How to use checksums |
24bb7410da7324a93813397bac1995184113b0cf5cfc783953bd5cc32e3a35d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
Security for swiftnode 5.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.