Skip to main content

Ultra-Powerful Personal AI Agent with Multi-Device Control, 100+ LLM Provider support via litellm, and 30+ tools

Project description

SwiftNode V5 ⚡

Python Version License Status PRs Welcome Platform

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.

FeaturesInstallationQuick StartCLI CommandsContributing


📖 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.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📝 License

Distributed under the MIT License. See LICENSE for more information.


Built with 💡 & ☕ by the SwiftNode Team

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

swiftnode-5.0.0.tar.gz (45.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

swiftnode-5.0.0-py3-none-any.whl (50.6 kB view details)

Uploaded Python 3

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

Hashes for swiftnode-5.0.0.tar.gz
Algorithm Hash digest
SHA256 d473c022a447a5e1d0923c9073b18923a501c300cb1bf7aeb5544bccd73542c5
MD5 ebd4f5daf35535bb75636e618f14a7a4
BLAKE2b-256 0ce507e4eeb9853e02949db5d8404174e1904272807f6b64f1d135af14700b7c

See more details on using hashes here.

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

Hashes for swiftnode-5.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cf17a684c7e00b9bc1b391f42f388ef8d4318d24954d7747c56e23c8f62cb2f4
MD5 ccd5e72887152e2f985cc8d22d6e0b75
BLAKE2b-256 24bb7410da7324a93813397bac1995184113b0cf5cfc783953bd5cc32e3a35d2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page