# Magic Flow Python SDK
A comprehensive Python SDK for building applications that interact with the Flow blockchain network. This SDK provides a complete set of tools for developers to query, transact, and build on Flow.
[](https://pypi.org/project/magic-flow/)
[](https://codecov.io/gh/magiclabs/magic-flow-python)
[](https://pypi.org/project/magic-flow/)
[](https://pypi.org/project/magic-flow/)
## Features
- 🔗 **Complete Flow Integration** - Full support for Flow blockchain operations
- 🚀 **Async/Await Support** - Modern Python async programming patterns
- 🔐 **Advanced Signing** - Support for complex transaction signing scenarios
- 📊 **Query Capabilities** - Query blocks, accounts, events, and transactions
- 🛠️ **Script Execution** - Execute Cadence scripts on the Flow network
- 🏗️ **Account Management** - Create and manage Flow accounts
- 📝 **Contract Deployment** - Deploy, update, and manage smart contracts
- 🧪 **Emulator Compatible** - Works with Flow Emulator for local development
## Quick Start
### Installation
Requires Python 3.10 or higher.
```bash
pip install magic-flow
```
Or with Poetry:
```bash
poetry add magic-flow
```
### Basic Usage
```python
import asyncio
from magic_flow.client import flow_client
async def main():
async with flow_client(host="127.0.0.1", port=3569) as client:
# Get the latest block
block = await client.get_latest_block()
print(f"Latest block height: {block.height}")
# Get account information
account = await client.get_account(address="0x01")
print(f"Account balance: {account.balance}")
if __name__ == "__main__":
asyncio.run(main())
```
## Documentation
- 📖 **[Complete Guide](https://magiclabs.github.io/magic-flow-python/python_SDK_guide/)** - Comprehensive documentation
- 🔧 **[API Reference](https://magiclabs.github.io/magic-flow-python/api_docs/)** - Detailed API documentation
- 💡 **[Examples](https://magiclabs.github.io/magic-flow-python/examples/)** - Code examples and tutorials
## Development
This SDK is fully compatible with the Flow Emulator and can be used for local development.
### Requirements
- Python 3.10+
- Flow Emulator (for local development)
### Contributing
We welcome contributions! Please see our [Contributing Guide](docs/contributing.md) for details.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Contributors
<a href="https://github.com/magiclabs/magic-flow-python/graphs/contributors">
<img src="https://contrib.rocks/image?repo=magiclabs/magic-flow-python" />
</a>
Made with [contrib.rocks](https://contrib.rocks).
Raw data
{
"_id": null,
"home_page": "https://github.com/magiclabs/magic-flow-python",
"name": "magic-flow",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Janez Podhostnik",
"author_email": "janez.podhostnik@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a1/96/41867b252413278d127a418376b1bc860ad6ec0e57460d63881f057e4e1a/magic_flow-0.1.2.tar.gz",
"platform": null,
"description": "# Magic Flow Python SDK\n\nA comprehensive Python SDK for building applications that interact with the Flow blockchain network. This SDK provides a complete set of tools for developers to query, transact, and build on Flow.\n\n[](https://pypi.org/project/magic-flow/)\n[](https://codecov.io/gh/magiclabs/magic-flow-python)\n[](https://pypi.org/project/magic-flow/)\n[](https://pypi.org/project/magic-flow/)\n\n## Features\n\n- \ud83d\udd17 **Complete Flow Integration** - Full support for Flow blockchain operations\n- \ud83d\ude80 **Async/Await Support** - Modern Python async programming patterns\n- \ud83d\udd10 **Advanced Signing** - Support for complex transaction signing scenarios\n- \ud83d\udcca **Query Capabilities** - Query blocks, accounts, events, and transactions\n- \ud83d\udee0\ufe0f **Script Execution** - Execute Cadence scripts on the Flow network\n- \ud83c\udfd7\ufe0f **Account Management** - Create and manage Flow accounts\n- \ud83d\udcdd **Contract Deployment** - Deploy, update, and manage smart contracts\n- \ud83e\uddea **Emulator Compatible** - Works with Flow Emulator for local development\n\n## Quick Start\n\n### Installation\n\nRequires Python 3.10 or higher.\n\n```bash\npip install magic-flow\n```\n\nOr with Poetry:\n\n```bash\npoetry add magic-flow\n```\n\n### Basic Usage\n\n```python\nimport asyncio\nfrom magic_flow.client import flow_client\n\nasync def main():\n async with flow_client(host=\"127.0.0.1\", port=3569) as client:\n # Get the latest block\n block = await client.get_latest_block()\n print(f\"Latest block height: {block.height}\")\n\n # Get account information\n account = await client.get_account(address=\"0x01\")\n print(f\"Account balance: {account.balance}\")\n\nif __name__ == \"__main__\":\n asyncio.run(main())\n```\n\n## Documentation\n\n- \ud83d\udcd6 **[Complete Guide](https://magiclabs.github.io/magic-flow-python/python_SDK_guide/)** - Comprehensive documentation\n- \ud83d\udd27 **[API Reference](https://magiclabs.github.io/magic-flow-python/api_docs/)** - Detailed API documentation\n- \ud83d\udca1 **[Examples](https://magiclabs.github.io/magic-flow-python/examples/)** - Code examples and tutorials\n\n## Development\n\nThis SDK is fully compatible with the Flow Emulator and can be used for local development.\n\n### Requirements\n\n- Python 3.10+\n- Flow Emulator (for local development)\n\n### Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](docs/contributing.md) for details.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Contributors\n\n<a href=\"https://github.com/magiclabs/magic-flow-python/graphs/contributors\">\n <img src=\"https://contrib.rocks/image?repo=magiclabs/magic-flow-python\" />\n</a>\n\nMade with [contrib.rocks](https://contrib.rocks).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python SDK for the Flow blockchain with updated dependencies and Python 3.13 support",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/magiclabs/magic-flow-python",
"Repository": "https://github.com/magiclabs/magic-flow-python"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "81062f6ebf135533e3037e52e1dfa27274ba11984f961f0321ad819672224b62",
"md5": "f217510c4e209c68284727f23970f11d",
"sha256": "056bbf62e359c79e52e8d96c4366025e473a80c6162a6dce290a28681bd03f0f"
},
"downloads": -1,
"filename": "magic_flow-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f217510c4e209c68284727f23970f11d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 50300,
"upload_time": "2025-10-06T21:46:31",
"upload_time_iso_8601": "2025-10-06T21:46:31.965211Z",
"url": "https://files.pythonhosted.org/packages/81/06/2f6ebf135533e3037e52e1dfa27274ba11984f961f0321ad819672224b62/magic_flow-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a19641867b252413278d127a418376b1bc860ad6ec0e57460d63881f057e4e1a",
"md5": "cf155ce985c1bb3ffbc36045041172b6",
"sha256": "04786728a77676e8a62445e0e294a5ca5763ea7b9cd2e57d8324d392b5294955"
},
"downloads": -1,
"filename": "magic_flow-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "cf155ce985c1bb3ffbc36045041172b6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 34352,
"upload_time": "2025-10-06T21:46:33",
"upload_time_iso_8601": "2025-10-06T21:46:33.131749Z",
"url": "https://files.pythonhosted.org/packages/a1/96/41867b252413278d127a418376b1bc860ad6ec0e57460d63881f057e4e1a/magic_flow-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-06 21:46:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "magiclabs",
"github_project": "magic-flow-python",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "magic-flow"
}
JSON
