{"id":13593918,"url":"https://github.com/fetchai/uAgents","last_synced_at":"2025-04-09T05:32:32.245Z","repository":{"id":103059564,"uuid":"542713154","full_name":"fetchai/uAgents","owner":"fetchai","description":"A fast and lightweight framework for creating decentralized agents with ease.","archived":false,"fork":false,"pushed_at":"2025-03-12T10:57:14.000Z","size":30916,"stargazers_count":1277,"open_issues_count":21,"forks_count":264,"subscribers_count":27,"default_branch":"main","last_synced_at":"2025-03-12T11:49:21.030Z","etag":null,"topics":["agents","ai","ai-agents","llm","multi-agent-systems"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fetchai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-28T17:31:19.000Z","updated_at":"2025-03-12T10:57:17.000Z","dependencies_parsed_at":"2023-10-16T21:09:23.166Z","dependency_job_id":"d4b05bbd-1fb5-4200-8a63-1976b649399e","html_url":"https://github.com/fetchai/uAgents","commit_stats":null,"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetchai%2FuAgents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetchai%2FuAgents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetchai%2FuAgents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetchai%2FuAgents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fetchai","download_url":"https://codeload.github.com/fetchai/uAgents/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247838417,"owners_count":21004575,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai","ai-agents","llm","multi-agent-systems"],"created_at":"2024-08-01T16:01:26.280Z","updated_at":"2025-04-09T05:32:32.225Z","avatar_url":"https://github.com/fetchai.png","language":"Python","funding_links":[],"categories":["Python","Automation","A01_文本生成_文本对话","Learning","其他LLM框架","Other LLM Frameworks","🤖 AI Agent Frameworks","Table of Open-Source AI Agents Projects","Agent Categories","4. Agentic AI \u0026 Multi-Agent Systems","AI Agents"],"sub_categories":["大语言对话模型及数据","Repositories","文章","Videos Playlists","\u003ca name=\"Unclassified\"\u003e\u003c/a\u003eUnclassified"],"readme":"# uAgents: AI Agent Framework\n\n[![Official Website](https://img.shields.io/badge/Official%20Website-fetch.ai-blue?style=flat\u0026logo=world\u0026logoColor=white)](https://fetch.ai) [![GitHub Repo stars](https://img.shields.io/github/stars/Fetchai/uAgents?style=social)](https://github.com/Fetchai/uAgents/stargazers) [![Twitter Follow](https://img.shields.io/twitter/follow/fetch_ai?style=social)](https://twitter.com/fetch_ai)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![Tests](https://img.shields.io/github/actions/workflow/status/Fetchai/uAgents/ci-tests.yml?label=Tests)](https://github.com/Fetchai/uAgents/actions/workflows/ci-tests.yml) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/uagents)\n\nuAgents is a library developed by Fetch.ai that allows for creating autonomous AI agents in Python. With simple and expressive decorators, you can have an agent that performs various tasks on a schedule or takes action on various events.\n\n## 🚀 Features\n\n- 🤖 **Easy creation and management**: Create any type of agent you can think of and implement it in code.\n- 🔗 **Connected**: On startup, each agent automatically joins the fast-growing network of uAgents by registering on the Almanac, a smart contract deployed on the Fetch.ai blockchain.\n- 🔒 **Secure**: uAgent messages and wallets are cryptographically secured, so their identities and assets are protected.\n\n## ⚡ Quickstart\n\n### Installation\n\nGet started with uAgents by installing it for Python 3.10 to 3.13:\n\n    pip install uagents\n\n### Running a Demo\n\n#### Creating an Agent\n\nBuild your first uAgent using the following script:\n\n```python3\nfrom uagents import Agent, Context\nalice = Agent(name=\"alice\", seed=\"alice recovery phrase\")\n```\n\nInclude a seed parameter when creating an agent to set fixed addresses, or leave it out to generate a new random address each time.\n\n#### Giving it a task\n\nGive it a simple task, such as a greeting:\n\n```python3\n@alice.on_interval(period=2.0)\nasync def say_hello(ctx: Context):\n    ctx.logger.info(f'hello, my name is {ctx.agent.name}')\n\nif __name__ == \"__main__\":\n    alice.run()\n```\n\n#### Running the Agent\n\nSo far, your code should look like this:\n\n```python3\nfrom uagents import Agent, Context\n\nalice = Agent(name=\"alice\", seed=\"alice recovery phrase\")\n\n@alice.on_interval(period=2.0)\nasync def say_hello(ctx: Context):\n    ctx.logger.info(f'hello, my name is {ctx.agent.name}')\n\nif __name__ == \"__main__\":\n    alice.run()\n```\n\nRun it using:\n\n```bash\npython agent.py\n```\n\nYou should see the results in your terminal.\n\n## 📖 Documentation\n\nPlease see the [official documentation](https://fetch.ai/docs) for full setup instructions and advanced features.\n\n- [👋 Introduction](https://fetch.ai/docs/concepts/agents/agents)\n- [💻 Installation](https://fetch.ai/docs/guides/agents/installing-uagent)\n- Tutorials\n  - [🤖 Create an agent](https://fetch.ai/docs/guides/agents/create-a-uagent)\n  - [🛣️ Agent Communication](https://fetch.ai/docs/guides/agents/communicating-with-other-agents)\n  - [🍽️ Restaurant Booking Demo](https://fetch.ai/docs/guides/agents/booking-demo)\n- Key Concepts:\n  - [📍Addresses](https://fetch.ai/docs/guides/agents/getting-uagent-address)\n  - [💾 Storage](https://fetch.ai/docs/guides/agents/storage-function)\n  - [📝 Interval Tasks](https://fetch.ai/docs/guides/agents/interval-task)\n  - [🌐 Agent Broadcast](https://fetch.ai/docs/guides/agents/broadcast)\n  - [⚙️ Almanac Contracts](https://fetch.ai/docs/guides/agents/register-in-almanac)\n\n## 🌱 Examples and Integrations\n\nThe [`uAgent-Examples`](https://github.com/fetchai/uAgent-Examples) repository contains several examples of how to create and run various types of agents as well as more intricate integrations. This is the official place for internal and community open source applications built on uAgents.\n\n## Python Library\n\nGo to the [`python`](https://github.com/fetchai/uAgents/tree/main/python) folder for details on the Python uAgents library.\n\n## uAgents Core\n\nThe [`uagents-core`](https://github.com/fetchai/uAgents/tree/main/python/uagents-core) folder contains core definitions and functionalities to build 'agent' like software which can interact and integrate with Fetch.ai ecosystem and agent marketplace.\n\n## ✨ Contributing\n\nAll contributions are welcome! Remember, contribution includes not only code, but any help with docs or issues raised by other developers. See our [contribution guidelines](https://github.com/fetchai/uAgents/blob/main/CONTRIBUTING.md) for more details.\n\n### 📄 Development Guidelines\n\nRead our [development guidelines](https://github.com/fetchai/uAgents/blob/main/DEVELOPING.md) to learn some useful tips related to development.\n\n### ❓ Issues, Questions, and Discussions\n\nWe use [GitHub Issues](https://github.com/fetchai/uAgents/issues) for tracking requests and bugs, and [GitHub Discussions](https://github.com/fetchai/uAgents/discussions) for general questions and discussion.\n\n## 🛡 Disclaimer\n\nThis project, uAgents, is provided \"as-is\" without any warranty, express or implied. By using this software, you agree to assume all risks associated with its use, including but not limited to unexpected behavior, data loss, or any other issues that may arise. The developers and contributors of this project do not accept any responsibility or liability for any losses, damages, or other consequences that may occur as a result of using this software.\n\n## License\n\nThe uAgents project is licensed under [Apache License 2.0](https://github.com/fetchai/uAgents/blob/main/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffetchai%2FuAgents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffetchai%2FuAgents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffetchai%2FuAgents/lists"}