Metadata-Version: 2.4
Name: mycelium-stellar
Version: 0.1.0
Summary: Mycelium — Python-first smart-contract + agent toolchain for Stellar/Soroban (one install: DSL, SDK, CLI, compiler). Install: pip install mycelium-stellar; import mycelium.
Author: Mycelium
Project-URL: Homepage, https://github.com/Srizdebnath/Mycelium
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mycelium-sdk==0.1.0
Requires-Dist: mycelium-cli==0.1.0
Requires-Dist: mycelium-compiler==0.1.0
Provides-Extra: langgraph
Requires-Dist: langgraph; extra == "langgraph"
Requires-Dist: langchain-core; extra == "langgraph"
Provides-Extra: gemini
Requires-Dist: google-generativeai; extra == "gemini"
Provides-Extra: anthropic
Requires-Dist: anthropic; extra == "anthropic"

# Mycelium

**The Python-first framework for smart-contract development and agentic orchestration on Stellar/Soroban.**

Installing `mycelium` gives you the whole toolchain in one shot:

- `import mycelium` — the contract-authoring DSL (`@contract`, `@external`, `@view`, typed primitives) plus the SDK facade (`AgentContext`, `HiveClient`, x402).
- `import mycelium_sdk` — the on-chain agent SDK (signing, live Soroban contract calls, hive discovery, escrow/x402, AI adapters).
- the `mycelium` CLI command — `init`, `newwallet`, `compile`, `check`, `deploy`, `register`, `agent`.
- the Python → Soroban-WASM compiler.

## Install

```bash
pip install mycelium
# optional AI-framework adapters:
pip install "mycelium[langgraph]"   # or [gemini] / [anthropic]
```

## Quickstart

```bash
mycelium init my_agent
cd my_agent
mycelium newwallet
mycelium compile
mycelium deploy --network testnet
mycelium register
```

```python
from mycelium import AgentContext, HiveClient

ctx = AgentContext(keypair_path=".mycelium/wallet.json", network_type="testnet")
hive = HiveClient(ctx)
hive.register("sentinel_alpha", ["data-analysis"], "https://sentinel.example/api")
print(hive.resolve_agent("sentinel_alpha"))
```

The `mycelium compile` / `deploy` commands need the `stellar` CLI (v27.0.0); the
compiler auto-downloads it on first use.

Licensed under MIT.
