Wesichain

Join the Wesichain Community

Wesichain is open source and built in public. We welcome contributions of all kinds.

Contributing

Dev Setup

# Clone the repo
git clone https://github.com/wesichain/wesichain.git
cd wesichain/wesichain

# Build all crates
cargo build

# Run all tests
cargo test

# Check formatting and lints (required before PR)
cargo fmt --check
cargo clippy -- -D warnings

Commit Conventions

All commits must follow Conventional Commits with a scope:

feat(wesichain-agent): add parallel tool execution
fix(wesichain-graph): resolve checkpoint deserialization edge case
chore(workspace): bump tokio to 1.44

PR Workflow

  1. Fork the repository and create a feature branch from main
  2. Make your changes with tests for all new functionality
  3. Run cargo fmt, cargo clippy, and cargo test locally
  4. Open a PR with a description of what changed and why
  5. Address any review feedback

Code Quality Requirements

  • Follow standard Rust naming conventions
  • Use async-trait for async trait implementations
  • Tests required for all new public APIs
  • No new unwrap() calls in library code — use ? and proper error types
  • cargo clippy -- -D warnings must pass with zero warnings

Code of Conduct

We are committed to a welcoming and inclusive community. All participants are expected to follow our Code of Conduct . Key principles:

  • Be respectful and considerate in all interactions
  • Critique ideas, not people
  • Harassment and exclusionary behavior will not be tolerated
  • Report violations via GitHub Issues or direct contact with maintainers

What's Next

v0.4 is focused on production hardening, expanded provider support, and a native Python SDK for interoperability. See the full ROADMAP.md for details.

v0.4 Highlights (planned)

  • OpenTelemetry distributed tracing across agents
  • Native Python bindings via PyO3
  • Multi-agent coordination primitives
  • Expanded vector store integrations (Pinecone, Milvus)