Mostro Core

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.

Requirements

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

Installing git-cliff

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

Using Cargo (Recommended)

cargo install git-cliff

Using Package Managers

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

Using Pre-built Binaries

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

Verify Installation

git cliff --version

Using git-cliff with a GitHub Personal Access Token (PAT)

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.

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.
Export the token as an environment variable before running git-cliff:
```
export GITHUB_TOKEN="<your-personal-access-token>"
```
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.

Features

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

Import prelude to use mostro core

use mostro_core::prelude::*;

Contribute

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.

Documentation

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

License

Mostro is licensed under the MIT license.

mostro-core 0.6.57