Skip to content

Commit 921b58f

Browse files
authored
Update README and SUPPORT with links to Discord (#80)
1 parent 8afaa4e commit 921b58f

File tree

2 files changed

+34
-10
lines changed

2 files changed

+34
-10
lines changed

README.md

+31-8
Original file line numberDiff line numberDiff line change
@@ -5,22 +5,25 @@ AlphaSwarm is a starter kit for building LLM-powered AI agents that interpret na
55
## Features
66

77
### AI-Powered Trading with Agents
8+
89
- 🤖 LLM-powered agents capable of processing complex, unstructured signals for trading decisions
910
- 🧠 Intelligent tool selection and chaining for complex multi-step analysis
1011
- 🚀 Dynamic composition and execution of Python code using available tools
1112
- 💬 Natural language strategy definition and real-time reasoning
1213
- 📊 Iterative agentic reasoning to evaluate market conditions, weigh multiple input signals, and make trading decisions given input trading strategy
1314

1415
### Trading & Execution
16+
1517
- ⚡ Real-time strategy execution and monitoring
1618
- 🔔 Flexible execution modes:
1719
- Automated trading alerts via Telegram
1820
- Autonomous trade execution
1921
- 🔄 Multi-chain support with growing DEX integrations:
20-
- Ethereum, Base, Coming Soon: Solana
22+
- Ethereum, Base, Coming Soon: Solana
2123
- Uniswap V2/V3, Coming Soon: Jupiter
2224

2325
### Modular Architecture
26+
2427
- 🛠️ Extensible plugin system for:
2528
- Data sources and signals
2629
- Trading strategies
@@ -30,16 +33,17 @@ AlphaSwarm is a starter kit for building LLM-powered AI agents that interpret na
3033
- 🔌 Easy integration of new data sources and execution venues
3134

3235
### Roadmap
36+
3337
- 🌐 Integration with Theoriq protocol to connect with growing ecosystem of agents and swarms providing trading strategies and signals
3438

3539
## Prerequisites
3640

3741
- Python 3.11 or higher
38-
- Download and install Python from [here](https://www.python.org/downloads/)
39-
- Verify installation with `python --version`
42+
- Download and install Python from [here](https://www.python.org/downloads/)
43+
- Verify installation with `python --version`
4044
- [Poetry](https://python-poetry.org/docs/) (package manager)
41-
- Install Poetry with `pipx install poetry`
42-
- Verify installation with `poetry --version`
45+
- Install Poetry with `pipx install poetry`
46+
- Verify installation with `poetry --version`
4347
- Basic understanding of crypto trading concepts
4448

4549
## Getting Started
@@ -51,12 +55,14 @@ First, ensure you have all prerequisites installed, including Python and poetry.
5155
Then follow these steps:
5256

5357
1. Clone the repository:
58+
5459
```bash
5560
git clone https://github.com/chain-ml/alphaswarm.git
5661
cd alphaswarm
5762
```
5863

5964
2. Install dependencies:
65+
6066
```bash
6167
# For basic installation
6268
poetry install
@@ -72,11 +78,13 @@ Note: Poetry manages its own virtual environments, so a separate virtual environ
7278
Before running the framework, you'll need to obtain several API keys:
7379

7480
1. **LLM API Key**:
81+
7582
- [Anthropic API Key](https://docs.anthropic.com/en/api/getting-started) if using Claude models (default)
7683
- [OpenAI API Key](https://platform.openai.com/docs/quickstart) if using GPT models
7784
- or any other LLM provider [supported by LiteLLM](https://models.litellm.ai/)
7885

7986
2. **Blockchain Access**:
87+
8088
- [Alchemy API Key](https://www.alchemy.com/) (required for blockchain data)
8189
- RPC URLs from [Alchemy](https://www.alchemy.com/) or [Infura](https://www.infura.io/) or another RPC provider of choice
8290

@@ -87,6 +95,7 @@ Before running the framework, you'll need to obtain several API keys:
8795
### 3. Environment Configuration
8896

8997
1. Create your environment file:
98+
9099
```bash
91100
cp .env.example .env
92101
```
@@ -96,37 +105,44 @@ cp .env.example .env
96105
#### Required environment variables:
97106

98107
LLM Configuration (at least one required):
108+
99109
- `ANTHROPIC_API_KEY`: Your Anthropic API key if using Claude models (default)
100110
- `OPENAI_API_KEY`: Your OpenAI API key if using GPT models
101111
- For any other provider ensure to follow the same pattern
102112

103113
Blockchain Access:
114+
104115
- `ALCHEMY_API_KEY`: Your Alchemy API key for accessing blockchain data
105116

106117
Ethereum Configuration (only if using Ethereum):
118+
107119
- `ETH_RPC_URL`: RPC endpoint URL for connecting to Ethereum network
108120
- `ETH_WALLET_ADDRESS`: Your Ethereum wallet address for trading
109121
- `ETH_PRIVATE_KEY`: Private key for your Ethereum wallet
110122

111123
Base Configuration (only if using Base):
112-
- `BASE_RPC_URL`: RPC endpoint URL for connecting to Base network
124+
125+
- `BASE_RPC_URL`: RPC endpoint URL for connecting to Base network
113126
- `BASE_WALLET_ADDRESS`: Your Base wallet address for trading
114127
- `BASE_PRIVATE_KEY`: Private key for your Base wallet
115128

116129
#### Optional configurations:
117130

118131
Testing environment variables:
132+
119133
- `ETH_SEPOLIA_RPC_URL`: Your Sepolia testnet RPC endpoint URL
120134
- `ETH_SEPOLIA_WALLET_ADDRESS`: Your Ethereum wallet address for Sepolia testnet
121135
- `ETH_SEPOLIA_PRIVATE_KEY`: Private key for your Sepolia testnet wallet
122136

123137
Notification settings:
138+
124139
- `TELEGRAM_BOT_TOKEN`: Required for sending alerts via Telegram bot
125140
- `TELEGRAM_CHAT_ID`: Required chat ID for receiving Telegram alerts
126141
- `TELEGRAM_SERVER_IP`: IP address for Telegram server (defaults to 0.0.0.0)
127142
- `TELEGRAM_SERVER_PORT`: Port for Telegram server (defaults to 8000)
128143

129144
Logging configuration:
145+
130146
- `LOG_LEVEL`: Sets logging verbosity level (defaults to INFO)
131147
- `LOG_FORMAT`: Custom format for log messages (default: "%(asctime)s - %(name)s - %(levelname)s - %(message)s")
132148

@@ -142,9 +158,10 @@ Logging configuration:
142158
The framework uses YAML configuration files to define trading venues, token pairs, and other application-specific and trading-related settings. The main configuration file is `config/default.yaml`.
143159

144160
Key configuration sections:
161+
145162
- **Network Environments**: Production and test network configurations
146163
- **Trading Venues**: Supported DEXs with their supported pairs and settings for each chain
147-
- **Chain Configuration**:
164+
- **Chain Configuration**:
148165
- Chain-specific wallet and RPC settings
149166
- Token addresses and decimals
150167
- Gas settings and transaction parameters
@@ -159,6 +176,7 @@ See [examples/README.md](examples/README.md) for more information about usage ex
159176
## Development
160177

161178
### Running Tests
179+
162180
```bash
163181
# Run all tests
164182
make all-tests
@@ -171,6 +189,7 @@ make integration-tests # Requires API keys to be specified
171189
### Code Quality
172190

173191
The project uses:
192+
174193
- Black for code formatting
175194
- isort for import sorting
176195
- ruff for linting
@@ -187,6 +206,7 @@ poetry run mypy .
187206
```
188207

189208
or use Makefile shortcuts:
209+
190210
```bash
191211
make dev-lint
192212
```
@@ -199,6 +219,8 @@ For security concerns, please review our [Security Policy](SECURITY.md). We take
199219

200220
Need help? Check out our [Support Guide](SUPPORT.md) for ways to get assistance.
201221

222+
We provide support and welcome feedback on our [Discord](https://discord.gg/theoriq-dev). We consider your feedback a gift and truly appreciate your meaningful contributions, which play a vital role in evolving our codebase.
223+
202224
## Contributing
203225

204226
Alphaswarm is a project under active development. We welcome all contributions, pull requests, feature requests or reported issues.
@@ -218,13 +240,15 @@ By using AlphaSwarm, you acknowledge and agree that:
218240
3. **No Financial Advice**: Nothing in this software constitutes financial, investment, legal, or tax advice. All trading strategies, examples, and code snippets are for illustrative purposes only.
219241

220242
4. **User Responsibility**: Users are solely responsible for:
243+
221244
- Understanding the risks involved
222245
- Conducting their own due diligence
223246
- Securing their private keys and funds
224247
- Testing thoroughly on testnets before using real funds
225248
- Setting appropriate risk management parameters
226249

227250
5. **No Warranty**: The software is provided "AS IS", without warranty of any kind, express or implied. The developers and contributors:
251+
228252
- Make no representations about its suitability for any purpose
229253
- Take no responsibility for any financial losses incurred
230254
- Do not guarantee the accuracy or reliability of any trading signals or decisions
@@ -236,4 +260,3 @@ USE OF THIS SOFTWARE FOR TRADING WITH REAL FUNDS SHOULD ONLY BE DONE WITH EXTREM
236260
## License
237261

238262
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
239-

SUPPORT.md

+3-2
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
1-
21
## How to file issues and get help
32

43
This project uses [GitHub Issues](https://github.com/chain-ml/alphaswarm/issues)
54
to track bugs and feature requests. Please search the existing
6-
issues before filing new issues to avoid duplicates. For new issues, file your bug or
5+
issues before filing new issues to avoid duplicates. For new issues, file your bug or
76
feature request as a new Issue.
7+
8+
Additionally, we provide support on our [Discord](https://discord.gg/theoriq-dev). Feel free to ask questions, discuss code, and talk about feature ideas or improvements!

0 commit comments

Comments
 (0)