simploxide-client

Crates.iosimploxide-client
lib.rssimploxide-client
version0.3.1
created_at2025-09-15 11:05:19.670637+00
updated_at2025-09-23 16:31:08.807774+00
descriptionSimpleX-Chat API client
homepage
repositoryhttps://github.com/a1akris/simploxide
max_upload_size
id1839771
size47,836
Oleksandr Kryvytskyi (a1akris)

documentation

https://docs.rs/simploxide-client

README

simploxide-client

SimpleX-Chat WebSocket client

🤖Try out SimplOxide bots right now!

  1. Install Rust if you haven't already.
  2. Get SimpleX chat CLI
  3. Run SimpleX Chat CLI with the following flags to prepare the bot account:
    simplex-chat --create-bot-display-name 'SimplOxide Examples' --create-bot-allow-files
    
    1. Alternatively, you can run this command from the SimpleX CLI itself:
      /create bot files=on 'SimplOxide Examples'
      
  4. Run SimpleX Chat CLI as an API server listening on port 5225(all example bots are connecting to this port by default):
    simplex-chat -p 5225
    
  5. Run the squaring bot:
    cargo run --example squaring_bot --all-features
    
    You can run any bot from examples/ directory by changing the --example argument.
    1. All example bots output their address when they start. Use this address to connect to your bot in SimpleX app(always prefer the shorter one): Addresses Screenshot

    2. Interact with the bot:

      Interactions Screenshot


Explore bot sources or read crate docs to learn how to write your own bots.

LICENSE

DISCLAIMER

SIMPLEX CLI HAS AN OPEN WEBSOCKET API, AND IT CAN BE ACCESSED FROM ANY LIBRARY OR APPLICATION, WHETHER OPEN-SOURCE OR NOT. THE SIMPLOXIDE LIBRARIES PROVIDE A WEBSOCKET CLIENT AND API CODECS FOR SIMPLEX CLI THAT DON'T DEPEND ON ANY CODE FROM THE SIMPLEX PROJECT AND THEREFORE ARE DUAL LICENSED UNDER APACHE-2.0/MIT AS STATED BELOW. APACHE-2.0/MIT TERMS AND CONDITIONS ARE APPLICABLE TO YOUR PROJECTS AS LONG AS THEY DON'T:

  • SHIP SIMPLEX-CLI OR ANY OTHER SIMPLEX COMPONENTS AS PART OF AN APPLICATION
  • USE FFI BINDINGS TO THE SIMPLEX-CORE OR OTHER SIMPLEX LIBRARIES
  • DEPEND ON OR INCLUDE ANYTHING ELSE LICENSED UNDER AGPL

OTHERWISE, YOUR PROJECTS MUST ADHERE TO SIMPLEX AGPL-3.0.

THIS IS NOT A LEGAL ADVICE BUT RATHER A FRIENDLY REMAINDER.

SIMPLOXIDE LIBRARIES AUTHORS DISCLAIM ALL RESPONSIBILITY AND LIABILITY FOR ANY FAILURE BY SIMPLOXIDE USERS TO COMPLY WITH THE AGPL-3.0.


Licensed under either of Apache License, Version 2.0 or MIT license at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Commit count: 39

cargo fmt