Metadata-Version: 2.4
Name: aser
Version: 0.1.3
Summary: An AI Agent
Author-email: rickey <hello_rickey@163.com>
License: MIT
Project-URL: Homepage, https://github.com/AmeNetwork/aser
Project-URL: Bug Tracker, https://github.com/AmeNetwork/aser/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.13.2
Description-Content-Type: text/markdown
Requires-Dist: openai>=1.63.2
Requires-Dist: web3>=7.8.0
Requires-Dist: discord-py-interactions>=5.14.0
Requires-Dist: python-telegram-bot>=21.10
Requires-Dist: tweepy>=4.15.0
Requires-Dist: supabase>=2.13.0
Requires-Dist: tinydb>=4.8.2
Requires-Dist: fastapi>=0.115.8
Requires-Dist: uvicorn>=0.34.0
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: chromadb>=0.6.3
Requires-Dist: tiktoken>=0.9.0
Requires-Dist: canonicaljson>=2.0.0
Requires-Dist: mastodon.py>=2.0.1
Requires-Dist: atproto>=0.0.59
Requires-Dist: rich>=13.9.4
Requires-Dist: bs4>=0.0.2
Requires-Dist: html2text>=2025.4.15
Requires-Dist: semchunk>=3.2.3
Requires-Dist: fastmcp>=2.12.0

# Aser

Aser is equipped with standardized AI capability middleware, such as knowledge, memory, tracing, thinking, API interfaces, and social clients. By dynamically integrating Web3 toolkits, it helps developers quickly build and launch AI agents with native Web3 capabilities.

![](./examples/images/architecture.png)

[Website](https://ame.network) | [Documentation](https://docs.ame.network/aser/overview) | [Get Support](https://t.me/hello_rickey) 

## Installation

**Install from pypi:**

```bash
pip3 install aser
```

**Clone the repository:**

```bash
git clone https://github.com/AmeNetwork/aser.git
cd aser
pip3 install -r requirements.txt
```

## Set up environment variables

Please refer to `.env.example` file, and create a `.env` file with your own settings. You can use two methods to import environment variables.

**Using python-dotenv:**

```bash
pip install python-dotenv
```

Then add the following code to your python file.

```python
from dotenv import load_dotenv
load_dotenv()
```

**Exporting all variables in the terminal:**

```bash
export $(grep -v '^#' .env | xargs)
```
## Basic Usage
```python
from aser.agent import Agent
agent=Agent(name="aser agent",model="gpt-4.1-mini")
response=agent.chat("what's bitcoin?")
print(response)
```

## Integrations & Examples

Create a Discord AI Agent [example](./examples/agent_discord.py)

Create a Telegram AI Agent [example](./examples/agent_telegram.py)

Create a Farcaster AI Agent [example](./examples/agent_farcaster.py)

Create an AI Agent with Memory [example](./examples/agent_memory.py)

Create an AI Agent with Knowledge [example](./examples/agent_knowledge.py)          

Create an AI Agent with Tools [example](./examples/agent_tools.py)  

Create an AI Agent with Toolkits [example](./examples/agent_toolkits.py)

Create an AI Agent with Trace [example](./examples/agent_trace.py)

Create an AI Agent with Model Smart Contract Protocol [example](./examples/agent_mscp.py)

Create an AI Agent Server [example](./examples/agent_server.py)

Create an AI Agent with CLI [example](./examples/agent_cli.py)

Create an AI Agent with Thinking [example](./examples/agent_thinking.py)

Create an AI Agent with Swarms [example](./examples/aser_swarms.py)

