Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Lastoneparis/OSHI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

46 Commits

Repository files navigation

OSHI Messenger

OSHI Messenger

The Most Private Messenger Ever Built

Zero-knowledge encryption. No phone number. Works offline.
Your messages belong to you β€” and only you.

iOS 17+ MIT License Open Source App Store

GitHub Stars Website


πŸ” What is OSHI?

OSHI is a zero-knowledge encrypted messenger designed for people who refuse to compromise on privacy. Unlike mainstream messengers that require your phone number, harvest metadata, and depend on centralized servers, OSHI takes a fundamentally different approach:

  • No phone number, no email β€” create an account with nothing but a username
  • End-to-end encrypted by default β€” every message, every call, every time
  • Works offline β€” communicate directly over Bluetooth and WiFi mesh networks
  • Zero metadata β€” we cannot see who talks to whom, when, or how often
  • Open source β€” every line of cryptographic code is auditable right here

OSHI is built for journalists, activists, security professionals, and anyone living in or traveling to regions where private communication is a matter of safety β€” not convenience.


🌟 Core Features

πŸ”’ End-to-End Encryption

OSHI implements the Signal Protocol (Double Ratchet) with modern cryptographic primitives:

Component Algorithm
Key Exchange X25519 (Curve25519 ECDH)
Message Encryption AES-256-GCM
Ratchet Protocol Double Ratchet (Signal Protocol)
Key Derivation HKDF-SHA256

Every message generates new encryption keys through the ratchet mechanism, providing forward secrecy and break-in recovery. Even if a key is compromised, past and future messages remain protected.


πŸ“‘ Mesh Networking

OSHI creates direct peer-to-peer connections between devices using Bluetooth LE and WiFi Direct β€” no internet required.

  • Range: ~100 meters between devices
  • Automatic peer discovery: devices find each other without manual configuration
  • Multi-hop relay: messages can route through intermediate peers
  • Zero server dependency: local messages never touch a server

Perfect for concerts, protests, disaster zones, remote areas, or any situation where internet access is unavailable or compromised.


🎭 Steganography (NEW)

OSHI introduces military-grade steganography β€” the ability to hide secret messages inside ordinary-looking content. This is a first for any mainstream messenger.

HUGO Algorithm β€” Image Steganography

Hide encrypted messages inside normal photographs. The embedded data is statistically undetectable, even under forensic analysis. Recipients extract the hidden message; everyone else sees a regular photo.

Text Steganography

Embed secret messages using zero-width Unicode characters within ordinary text. The message looks completely normal to anyone reading it β€” the hidden payload is invisible to the human eye.

6 Covert Channel Families

OSHI implements six distinct families of network covert channels for censorship bypass in hostile network environments:

  • Timing-based channels
  • Protocol header manipulation
  • DNS covert channels
  • HTTP field encoding
  • Packet size modulation
  • Traffic pattern mimicry

These channels allow OSHI to function even when deep packet inspection (DPI) is actively blocking encrypted messenger traffic.


πŸ€– Bot API (NEW)

Build automation on top of OSHI with a Telegram-like Bot API. Create bots that can:

  • Send messages to groups and channels
  • Respond to commands
  • Run on schedules (cron-style)
  • Moderate content
  • Integrate with external services via webhooks

A complete Python SDK is included in the sdk/ directory. See the Bot SDK section below for a quick start.


🧠 AI Offline (NEW)

OSHI integrates Apple Intelligence for on-device natural language processing on iOS 26+:

  • Smart text corrections β€” grammar and style suggestions without sending text to the cloud
  • Translation β€” 16+ languages, processed entirely on-device
  • Contextual suggestions β€” intelligent replies powered by on-device NLP
  • Zero cloud dependency β€” all AI processing happens on your device's Neural Engine

Your conversations are never analyzed by external servers. Intelligence stays local.


πŸ“ž Encrypted Voice Calls

Real-time voice calls with full end-to-end encryption:

  • CallKit integration β€” native iOS call UI and experience
  • Voice effects β€” optional voice modification for identity protection
  • Works over mesh or internet β€” adaptive routing
  • China-compliant β€” compatible with MIIT regulations for users in mainland China

🌐 IPFS & Tor Integration

When direct communication isn't possible, OSHI falls back to decentralized infrastructure:

  • IPFS β€” messages stored on a decentralized network, no single point of failure
  • Tor routing β€” optional onion routing for maximum anonymity
  • 30-day ephemeral storage β€” messages automatically expire from IPFS nodes
  • Censorship-resistant β€” no central server to block or seize

πŸ’¨ Disappearing Messages

Control the lifecycle of every message you send:

  • View-once β€” message is destroyed after a single viewing
  • Auto-delete timers β€” set messages to disappear after minutes, hours, or days
  • Screenshot blocking β€” prevents screen capture on the recipient's device
  • No forensic traces β€” securely wiped from device storage

πŸ“Š Feature Comparison

How OSHI compares to other messaging platforms:

Feature OSHI Signal Telegram WhatsApp Session
No Phone Required βœ… ❌ ❌ ❌ βœ…
Works Offline βœ… ❌ ❌ ❌ ❌
Steganography βœ… ❌ ❌ ❌ ❌
Bot API βœ… ❌ βœ… ❌ ❌
AI Offline βœ… ❌ ❌ ❌ ❌
Covert Channels βœ… ❌ ❌ ❌ ❌
Open Source βœ… βœ… ⚠️ Client ❌ βœ…
E2E Encryption βœ… βœ… ⚠️ Secret chats βœ… βœ…
Mesh Network βœ… ❌ ❌ ❌ ❌
Zero Metadata βœ… ⚠️ Partial ❌ ❌ βœ…

πŸ—οΈ Architecture

OSHI is built as a native iOS application in Swift, with a decentralized backend architecture. For the complete technical deep-dive, see Architecture.md.

OSHI/
β”œβ”€β”€ src/ # Core Swift source files
β”‚ β”œβ”€β”€ DoubleRatchet.swift # Signal Protocol implementation
β”‚ β”œβ”€β”€ MeshNetworkManager.swift # Bluetooth/WiFi P2P mesh
β”‚ β”œβ”€β”€ SteganographyManager.swift # HUGO image steganography
β”‚ β”œβ”€β”€ TextSteganography.swift # Zero-width Unicode encoding
β”‚ β”œβ”€β”€ NetworkSteganography.swift # Network covert channels
β”‚ β”œβ”€β”€ CovertChannelManager.swift # 6-family covert channel engine
β”‚ β”œβ”€β”€ BotManager.swift # Bot API server-side logic
β”‚ β”œβ”€β”€ NLPManager.swift # Apple Intelligence / NLP
β”‚ β”œβ”€β”€ VoiceCallManager.swift # E2E encrypted calls + CallKit
β”‚ └── ChinaRegionDetector.swift # MIIT compliance detection
β”œβ”€β”€ sdk/ # Python Bot SDK
β”‚ β”œβ”€β”€ oshi_bot.py # Bot SDK client library
β”‚ └── examples/ # Example bot implementations
β”œβ”€β”€ docs/ # Technical documentation
β”‚ β”œβ”€β”€ encryption.md # Cryptographic protocol details
β”‚ └── protocol.md # Communication protocol spec
β”œβ”€β”€ assets/ # Logo, screenshots, media
β”œβ”€β”€ Architecture.md # System architecture overview
β”œβ”€β”€ Security.md # Security model & bug bounty
└── LICENSE # MIT License

πŸ€– Bot SDK

The OSHI Bot SDK lets you build bots in Python that interact with OSHI groups and channels β€” similar to Telegram's Bot API.

Installation

# Download the SDK
curl -O https://raw.githubusercontent.com/Lastoneparis/OSHI/main/sdk/oshi_bot.py

Or clone the repository:

git clone https://github.com/Lastoneparis/OSHI.git
cd OSHI/sdk

Quick Start

from oshi_bot import OshiBot
# Initialize with your bot token (created in the OSHI app)
bot = OshiBot(token="YOUR_BOT_TOKEN")
# Send a message to a group
bot.send("GROUP_ID", "Hello from my OSHI bot!")

Creating a Bot

  1. Open the OSHI app
  2. Navigate to Portal > Bots > Create
  3. Copy the bot token
  4. Assign the bot to a group
  5. Use the SDK to send messages

Bot Types

  • Webhook bots β€” respond to incoming messages in real time
  • Scheduled bots β€” send messages on a cron schedule
  • Moderator bots β€” automate group moderation
  • Integration bots β€” bridge OSHI with external services

Full API documentation: https://oshi-messenger.com/bot-api


πŸ›‘οΈ Security

OSHI's security model is designed around a single principle: we cannot read your messages, even if compelled by law. We have zero access to plaintext content, encryption keys, or social graphs.

Key properties:

  • Zero knowledge β€” the server never sees plaintext or keys
  • Forward secrecy β€” compromising a key does not expose past messages
  • Break-in recovery β€” the ratchet automatically heals after a compromise
  • No metadata β€” we do not log who communicates with whom
  • Open source β€” audit the cryptographic implementation yourself

For the full security model, threat analysis, and cryptographic specifications, see:


πŸ“± Download

Download on the App Store

Available on iPhone and iPad running iOS 17+
https://oshi-messenger.com


🀝 Contributing

We welcome contributions from the community! OSHI is open source under the MIT License, and we believe privacy tools are strongest when built in the open.

Ways to contribute:

  • Report bugs β€” open an issue
  • Suggest features β€” start a discussion
  • Submit code β€” fork the repo and open a pull request
  • Audit security β€” review the cryptographic implementation and report findings
  • Translate β€” help bring OSHI to more languages

Please read the code of conduct before contributing. All contributions are subject to the MIT License.


πŸ’° Bug Bounty

We take security seriously. If you discover a vulnerability in OSHI, we want to hear about it.

Severity Reward
Critical (RCE, key extraction, E2E bypass) Up to 5,000ドル
High (authentication bypass, data leak) Up to 2,500ドル
Medium (XSS, CSRF, information disclosure) Up to 1,000ドル
Low (minor issues, best practice violations) Up to 250ドル

Contact: hugomoriceau@icloud.com

Please practice responsible disclosure. Give us 90 days to address the issue before public disclosure. See Security.md for full details.


πŸ“œ License

OSHI is released under the MIT License .

MIT License
Copyright (c) 2026 OSHI
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

πŸ™ Acknowledgments


Made with care in Switzerland πŸ‡¨πŸ‡­
Privacy is not a luxury β€” it's a fundamental right.

Website Β· App Store Β· GitHub Β· Contact

About

Private encrypted messenger with steganography, bot API, AI offline, mesh networking, and covert channels. E2E encrypted. No phone number required.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /