this-me

this-me is a lightweight identity expression built in Rust that allows you to create, manage, and securely store minimal user identity files locally. It is part of the Neurons.me ecosystem and is designed for applications where user-controlled identity and privacy are fundamental.

🧱 Architecture

• The Me struct represents an identity.
• Identity files are loaded using Me::load(username, hash).
• Verbs (e.g. have, be, say, etc.) are applied as methods on a loaded Me.
• After modifying the identity with verbs, me.save() must be called to persist changes.

✨ Features

• Create a local identity file with a username and a hash password-derived encryption key
• Decrypt and view stored identity data
• Change the hash (password) for an identity
• Delete the identity file securely

📦 Installation

To install this-me, you need to have Rust installed. Then run:

cargo install this-me

Or, if you're working in the repository:

cargo build --release

🚀 Usage

Each command is executed via the CLI binary me. Identity loading is done automatically and implicitly by each command.

Create Identity

me create <username> <password>

Initializes a new identity file under .this/me/<username>.me using the given password to encrypt it.

Display Identity

me display <username> <password>

Decrypts and displays the identity file contents.

Verbs (Modify Identity)

me be <username> <password> <key> <value>
me have <username> <password> <key> <value>
me say <username> <password> <key> <value>

These commands modify the identity in memory after loading it, and then save the changes automatically.

Delete Identity

me delete <username> <password>

Deletes the identity file, only if the provided password is correct.

Change Password (Hash)

me change-hash <username> <old_password> <new_password>

Changes the encryption hash for the identity file.

📚 Using as a Library

use this_me::Me;

let mut me = Me::load("suigeneris", "1234")?;
me.be("musician", "true")?;
me.save()?;

📂 Identity File Location

Identity files are stored in:

~/.this/me/<username>.me

This path is hidden and local to your machine.

⚠️ Username & Password Rules

• Usernames must be 5–21 characters long and only include letters, numbers, . or _.
• Passwords must be at least 4 characters long.

🧠 Project Goals

this-me aims to decentralize identity management. Instead of relying on external servers or cloud providers, identities are stored and encrypted locally by the user. This forms the basis of a self-sovereign identity approach, aligned with the broader goals of the Neuroverse ecosystem — building tech that empowers individuals to control their own digital footprint.

🛠 Development

To run tests or debug:

cargo test
cargo run --bin me -- <command> ...

Built with ❤️ as part of the Neuroverse initiative.