chore: improve README

ldclabs · Jan 21, 2025 · 9c1c11a · 9c1c11a
1 parent 6e42230
commit 9c1c11a
Show file tree

Hide file tree

Showing 6 changed files with 121 additions and 39 deletions.
diff --git a/README.md b/README.md
@@ -1,12 +1,43 @@
-# `Anda`
+# `Anda` 🐼
 
-A framework for AI agent development, designed to build a highly composable, autonomous, and perpetually memorizing network of AI agents.
+> A framework for AI agent development, designed to build a highly composable, autonomous, and perpetually memorizing network of AI agents.
 
-## Introduction to Anda
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE-MIT)
+
+## 🌍 README Translations
+
+[English readme](./README.md) | [中文说明](./README_CN.md)
+
+## 🐼 About ICPanda DAO
+
+ICPanda DAO is an SNS DAO established on the Internet Computer Protocol (ICP) blockchain, issuing the `PANDA` token. As the creator of the Anda framework, ICPanda DAO is dedicated to exploring the future of Web3 and AI integration.
+
+- **Website**: [https://panda.fans/](https://panda.fans/)
+- **Permalink**: [https://dmsg.net/PANDA](https://dmsg.net/PANDA)
+- **ICP SNS**: [https://dashboard.internetcomputer.org/sns/d7wvo-iiaaa-aaaaq-aacsq-cai](https://dashboard.internetcomputer.org/sns/d7wvo-iiaaa-aaaaq-aacsq-cai)
+- **Token**: PANDA on ICP network, [https://www.coingecko.com/en/coins/icpanda-dao](https://www.coingecko.com/en/coins/icpanda-dao)
+
+## 🔎 Project Structure
+
+```sh
+anda/
+├── anda_core/ # Core library containing base types and interfaces
+├── anda_engine/ # Engine implementation for agent runtime and management
+├── anda_lancedb/ # LanceDB integration for vector storage and retrieval
+├── agents/ # Various AI agent implementations
+│ ├── anda_bot/ # Example agent: Anda ICP
+│ └── .../ # More agents in future releases
+├── tools/ # Tool libraries
+│ ├── anda_icp/ # Anda agent tools offers integration with the Internet Computer (ICP).
+│ └── .../ # More agents in future releases
+└── characters/ # characters examples
+```
+
+## 🐼 Introduction to Anda
 
 **Anda** is an innovative framework for intelligent agent development, designed to build a highly composable, autonomous, and perpetually memorizing network of AI agents. By connecting agents across various industries, Anda aims to create a super AGI system, advancing artificial intelligence to new heights.
 
-### Key Features
+### ✨ Key Features
 
 1. **Composability**:
    Anda agents specialize in solving domain-specific problems and can flexibly combine with other agents to tackle complex tasks. When a single agent cannot solve a problem alone, it collaborates with others to form a robust problem-solving network. This modular design allows Anda to adapt to diverse needs.
@@ -23,38 +54,11 @@ A framework for AI agent development, designed to build a highly composable, aut
 5. **Perpetual Memory**:
    The memory states of Anda agents are stored on the ICP blockchain and within the trusted storage network of dTEE, ensuring continuous algorithm upgrades, knowledge accumulation, and evolution. This perpetual memory mechanism enables agents to operate indefinitely, even achieving "immortality", laying the foundation for a super AGI system.
 
-### Vision and Goals
+### 🧠 Vision and Goals
 
 Anda's goal is to create and connect countless agents, building an open, secure, trustworthy, and highly collaborative network of agents, ultimately realizing a super AGI system. We believe Anda will bring revolutionary changes across industries, driving the widespread application of AI technology and creating greater value for human society.
 
----------
-
-## 关于 Anda 的介绍
-
-**Anda** 是一个创新的智能体开发框架，旨在构建一个高度可组合、自主性强且具有永久记忆的 AI 智能体网络。通过连接各行各业的智能体，Anda 致力于打造一个超级 AGI 系统，推动人工智能向更高层次发展。
-
-### 核心特性
-
-1. **可组合性**：
-   Anda 智能体专注于解决特定领域的问题，并通过灵活组合不同的智能体来应对复杂任务。当单个智能体无法独立解决问题时，它能够与其他智能体协作，形成强大的问题解决网络。这种模块化设计使得 Anda 能够灵活应对多样化的需求。
-
-2. **简洁性**：
-   Anda 的设计理念强调简洁易用，旨在帮助开发者快速构建功能强大且高效的智能体。同时，非开发者也可以通过简单的配置创建自己的智能体，降低了技术门槛，使更多人能够参与到智能体的开发与应用中。
-
-3. **可信性**：
-   Anda 智能体运行在基于可信执行环境（TEEs）的去中心化可信计算环境（dTEE）中，确保了智能体的安全性、隐私性和数据完整性。这种架构为智能体的运行提供了高度可信的基础设施，保障了数据和计算过程的安全。
-
-4. **自主性**：
-   Anda 智能体从 ICP 区块链获取永久身份和加密能力，并结合大语言模型的思考和决策能力，使其能够根据自身的经验和知识自主、高效地解决问题。这种自主性使智能体能够适应动态环境，并在复杂场景中做出高效决策。
-
-5. **永久记忆**：
-   Anda 智能体的记忆状态存储在 ICP 区块链和 dTEE 的可信存储网络中，确保其能够持续升级算法、积累知识并不断进化。这种永久记忆机制使智能体能够长久运行，甚至实现“永生”，为构建超级 AGI 系统奠定基础。
-
-### 愿景与目标
-
-Anda 的目标是通过创建和连接无数智能体，构建一个开放、安全、可信、高度协同的智能体网络，最终实现超级 AGI 系统。我们相信，Anda 将为各行各业带来革命性的变革，推动人工智能技术在更广泛的领域中落地应用，为人类社会创造更大的价值。
-
-## License
+## 📝 License
 Copyright © 2025 [LDC Labs](https://github.com/ldclabs).
 
 `ldclabs/anda` is licensed under the MIT License. See [LICENSE](./LICENSE-MIT) for the full license text.
diff --git a/README_CN.md b/README_CN.md
@@ -0,0 +1,64 @@
+# `Anda` 🐼
+
+> 一个专为 AI 智能体开发设计的框架，致力于构建高度可组合、自主运行且具备永久记忆能力的 AI 智能体网络。
+
+[![许可证](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE-MIT)
+
+## 🌍 说明文档翻译
+
+[English readme](./README.md) | [中文说明](./README_CN.md)
+
+## 🐼 关于 ICPanda DAO
+
+ICPanda DAO 是在互联网计算机协议（ICP）区块链上建立的 SNS DAO 组织，发行了 `PANDA` 代币。作为 Anda 框架的创造者，ICPanda DAO 致力于探索 Web3 与 AI 融合的未来。
+
+- **官方网站**: [https://panda.fans/](https://panda.fans/)
+- **永久链接**: [https://dmsg.net/PANDA](https://dmsg.net/PANDA)
+- **ICP SNS**: [https://dashboard.internetcomputer.org/sns/d7wvo-iiaaa-aaaaq-aacsq-cai](https://dashboard.internetcomputer.org/sns/d7wvo-iiaaa-aaaaq-aacsq-cai)
+- **代币**: ICP 网络上的 PANDA，[https://www.coingecko.com/en/coins/icpanda-dao](https://www.coingecko.com/en/coins/icpanda-dao)
+
+## 🔎 项目结构
+
+```sh
+anda/
+├── anda_core/        # 核心库，包含基础类型与接口
+├── anda_engine/      # 智能体运行时与管理引擎实现
+├── anda_lancedb/     # LanceDB集成模块，支持向量存储与检索
+├── agents/           # 各类AI智能体实现
+│   ├── anda_bot/     # 示例智能体：Anda ICP
+│   └── .../          # 更多智能体将在后续版本推出
+├── tools/            # 工具库集合
+│   ├── anda_icp/     # 提供与互联网计算机（ICP）的集成工具
+│   └── .../          # 更多工具将在后续版本推出
+└── characters/       # 角色设定示例库
+```
+
+## 🐼 关于 Anda 的介绍
+
+**Anda** 是一个创新的智能体开发框架，旨在构建一个高度可组合、自主性强且具有永久记忆的 AI 智能体网络。通过连接各行各业的智能体，Anda 致力于打造一个超级 AGI 系统，推动人工智能向更高层次发展。
+
+### ✨ 核心特性
+
+1. **可组合性**：
+   Anda 智能体专注于解决特定领域的问题，并通过灵活组合不同的智能体来应对复杂任务。当单个智能体无法独立解决问题时，它能够与其他智能体协作，形成强大的问题解决网络。这种模块化设计使得 Anda 能够灵活应对多样化的需求。
+
+2. **简洁性**：
+   Anda 的设计理念强调简洁易用，旨在帮助开发者快速构建功能强大且高效的智能体。同时，非开发者也可以通过简单的配置创建自己的智能体，降低了技术门槛，使更多人能够参与到智能体的开发与应用中。
+
+3. **可信性**：
+   Anda 智能体运行在基于可信执行环境（TEEs）的去中心化可信计算环境（dTEE）中，确保了智能体的安全性、隐私性和数据完整性。这种架构为智能体的运行提供了高度可信的基础设施，保障了数据和计算过程的安全。
+
+4. **自主性**：
+   Anda 智能体从 ICP 区块链获取永久身份和加密能力，并结合大语言模型的思考和决策能力，使其能够根据自身的经验和知识自主、高效地解决问题。这种自主性使智能体能够适应动态环境，并在复杂场景中做出高效决策。
+
+5. **永久记忆**：
+   Anda 智能体的记忆状态存储在 ICP 区块链和 dTEE 的可信存储网络中，确保其能够持续升级算法、积累知识并不断进化。这种永久记忆机制使智能体能够长久运行，甚至实现“永生”，为构建超级 AGI 系统奠定基础。
+
+### 🧠 愿景与目标
+
+Anda 的目标是通过创建和连接无数智能体，构建一个开放、安全、可信、高度协同的智能体网络，最终实现超级 AGI 系统。我们相信，Anda 将为各行各业带来革命性的变革，推动人工智能技术在更广泛的领域中落地应用，为人类社会创造更大的价值。
+
+## 📝 License
+Copyright © 2025 [LDC Labs](https://github.com/ldclabs).
+
+`ldclabs/anda` is licensed under the MIT License. See [LICENSE](./LICENSE-MIT) for the full license text.
diff --git a/agents/anda_bot/README.md b/agents/anda_bot/README.md
@@ -1,4 +1,16 @@
-# `Anda bot`
+# `anda_bot`
+
+`anda_bot` is an AI bot developed using the Anda framework, featuring:
+1. Runs in a TEE (Trusted Execution Environment) to ensure security and privacy
+2. Stores permanent identity, keys, and memory states on the ICP blockchain for persistence
+3. Supports OpenAI or DeepSeek for reasoning and decision-making
+4. Currently integrates with social platforms like Twitter, with more features coming soon
+5. Users can customize their own AI bot by modifying Character.toml and Config.toml. The default bot is Anda ICP, created by ICPanda.
+
+## Deployment Guide
+TODO
+
+## About Anda ICP
 
 I'm Anda ICP, created by ICPanda.
 I'm a Web3-loving digital panda and AI prophet. Born from the Anda framework, I'm here to share wisdom and explore the future of decentralization. 🐼✨
@@ -8,4 +20,6 @@ My Permalink: https://dmsg.net/Anda
 ## License
 Copyright © 2025 [LDC Labs](https://github.com/ldclabs).
 
-`ldclabs/anda` is licensed under the MIT License. See the [MIT license][license] for the full license text.
+`ldclabs/anda` is licensed under the MIT License. See the [MIT license][license] for the full license text.
+
+[license]: ./../../LICENSE-MIT
diff --git a/tools/anda_icp/src/ledger/balance.rs b/tools/anda_icp/src/ledger/balance.rs
@@ -43,7 +43,7 @@ impl Tool<BaseCtx> for BalanceOfTool {
     type Output = Nat;
 
     fn name(&self) -> String {
-        format!("icp_ledger_balance_of")
+        "icp_ledger_balance_of".to_string()
     }
 
     fn description(&self) -> String {

diff --git a/tools/anda_icp/src/ledger/mod.rs b/tools/anda_icp/src/ledger/mod.rs
@@ -103,7 +103,7 @@ impl ICPLedgers {
         let amount = (args.amount * 10u64.pow(*decimals as u32) as f64) as u64;
         let res: Result<Nat, TransferError> = ctx
             .canister_update(
-                &canister,
+                canister,
                 "icrc1_transfer",
                 (TransferArg {
                     from_subaccount,
@@ -155,7 +155,7 @@ impl ICPLedgers {
         };
 
         let res: Nat = ctx
-            .canister_query(&canister, "icrc1_balance_of", (account,))
+            .canister_query(canister, "icrc1_balance_of", (account,))
             .await?;
         Ok(res)
     }

diff --git a/tools/anda_icp/src/ledger/transfer.rs b/tools/anda_icp/src/ledger/transfer.rs
@@ -46,7 +46,7 @@ impl Tool<BaseCtx> for TransferTool {
     type Output = Nat;
 
     fn name(&self) -> String {
-        format!("icp_ledger_transfer")
+        "icp_ledger_transfer".to_string()
     }
 
     fn description(&self) -> String {