RF Swift is a revolutionary toolbox that transforms any computer into a powerful RF testing laboratory without requiring a dedicated operating system. 🔄 Unlike traditional approaches that force you to sacrifice your primary OS, RF Swift brings containerized RF tools to your existing environment. 🏠

• 🏠 Non-disruptive Integration: Run specialized RF tools while continuing to use your preferred OS for daily work
• 🧩 Modular Tool Selection: Deploy only the tools you need, when you need them
• 🛡️ Containerized Isolation: Prevent RF tools from affecting system stability or security
• 🌍 Cross-platform Compatibility: Works seamlessly on Linux, Windows, and macOS
• 🔌 Dynamic Hardware Integration: Connect and disconnect USB devices without restarting
• 🛠️ Custom Environment Creation: Build specialized images for specific assessment needs
• ⚡ GPU Acceleration: Dedicated images with OpenCL support for Intel and NVIDIA GPUs, and more
• 💾 Space Efficiency: Use a fraction of the disk space required by dedicated OS solutions
• 🔄 Version Control: Maintain multiple tool versions simultaneously without conflicts

# Clone the repository
git clone https://github.com/PentHertz/RF-Swift.git
cd RF-Swift

# Run the installation script
./install.sh

The script will:

• 📦 Install Docker, BuildX, and Go (if needed)
• 🔨 Build the RF Swift binary
• 🔊 Configure audio and X11 forwarding
• 🔗 Create an alias for easy access

# Clone the repository
git clone https://github.com/PentHertz/RF-Swift.git
cd RF-Swift

# Run the Windows build script
.\build-windows.bat

Additionally, install:

• 🐳 Docker Desktop for Windows
• 🔌 usbipd for USB device forwarding

# Pull a pre-built image
rfswift images pull -i sdr_full

# Create and run a container
rfswift run -i penthertz/rfswift:sdr_full -n my_sdr_container

RF Swift's container approach allows for specialized environments optimized for specific tasks:

• 🧰 Assessment Readiness: Deploy an RF and hardware lab in minutes at a client site
• 🔄 Tool Consistency: Eliminate "works on my machine" issues with consistent environments
• ⚙️ Parallel Workflows: Run multiple isolated assessments simultaneously
• 📋 Document Storage: Keep reports and evidence separate from tools
• 🛠️ Custom Toolsets: Create specialized containers for specific engagements

• 📊 Reproducible Research: Share exact tool environments with colleagues
• 🧪 Experiment Isolation: Prevent experimental configurations from affecting other work
• 🌐 Multi-platform Collaboration: Collaborate across Linux, Windows, and macOS
• 🔢 Version Control: Test with specific tool versions without compatibility issues
• ⚡ Resource Efficiency: Optimize container resources for specific research tasks

• 🏫 Classroom Deployment: Identical environments for all students
• 💻 No Reformatting: Students keep their existing OS
• 🖥️ Low Hardware Requirements: Works on standard lab computers
• 📚 Focused Learning: Custom containers with only the tools needed for specific lessons
• 🔄 Quick Reset: Easily reset environments between classes

Comprehensive documentation is available at rfswift.io, including:

• 🚀 Getting Started Guide
• 🏁 Quick Start Tutorial
• 📘 User Guide
• 👨‍💻 Development Documentation
• 🧰 List of Included Tools

• 💬 Join our Discord for community support
• 🐛 Report issues on GitHub
• 🐦 Follow FlUxIuS and Penthertz on X (Twitter)

Contributions are welcome! Here's how you can help:

• 🧰 Tool Integration: Add new tools or improve existing ones
• 📝 Documentation: Improve guides and examples
• 🐞 Bug Reports: Report issues you encounter
• 💡 Feature Requests: Suggest new features or improvements
• 👨‍💻 Code Contributions: Submit PRs to enhance functionality

RF Swift is released under GNU GPLv3 license. See LICENSE file for details.