Mostro Core is a Rust-based library that provides peer-to-peer functionality for decentralized applications. It serves as the foundation for building Mostro daemon.

• Rust 1.86.0 or later
• Cargo (Rust's package manager)
• cargo-release for releasing new versions
• git-cliff for generating the changelog

git-cliff is used to automatically generate changelogs from git commits. You can install it using one of the following methods:

cargo install git-cliff

• Ubuntu/Debian: sudo apt install git-cliff
• macOS (Homebrew): brew install git-cliff
• Arch Linux: sudo pacman -S git-cliff
• Fedora: sudo dnf install git-cliff

Download the latest release from the git-cliff releases page and extract the binary to your PATH.

git cliff --version

When git-cliff queries GitHub (e.g., for PR titles, authors, or labels), you may need a PAT to avoid rate limits or access private repos.

1. Create a PAT in GitHub Settings → Developer settings → Personal access tokens. For public repositories, the default scopes are sufficient; for private repos, include the repo scope.

2. Export the token as an environment variable before running git-cliff:

   export GITHUB_TOKEN="<your-personal-access-token>"

3. Run git-cliff, pointing it at the repository if needed:

git cliff --github-repo "MostroP2P/mostro-core"

Alternatively, you can pass the token via CLI flag or config:

# CLI flag
git cliff --github-repo "MostroP2P/mostro-core" --github-token "$GITHUB_TOKEN"

# In cliff.toml
[remote.github]
owner = "MostroP2P"
repo = "mostro-core"
token = "${GITHUB_TOKEN}"

Security tip: Prefer environment variables over hardcoding tokens in files. Rotate or revoke PATs regularly.

• Peer-to-peer networking capabilities
• Secure communication protocols
• Efficient data synchronization
• Cross-platform compatibility

use mostro_core::prelude::*;

You may be interested in contributing to Mostro. If you're looking for somewhere to start contributing, check out the good first issue list.

More info in our contributing guide and the focused Repository Guidelines for agent contributors.

• Protocol documentation: https://mostro.network/protocol
• Frequently Asked Questions: in English, in Spanish.

Mostro is licensed under the MIT license.