You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -72,11 +78,13 @@ Note: Poetry manages its own virtual environments, so a separate virtual environ
72
78
Before running the framework, you'll need to obtain several API keys:
73
79
74
80
1.**LLM API Key**:
81
+
75
82
-[Anthropic API Key](https://docs.anthropic.com/en/api/getting-started) if using Claude models (default)
76
83
-[OpenAI API Key](https://platform.openai.com/docs/quickstart) if using GPT models
77
84
- or any other LLM provider [supported by LiteLLM](https://models.litellm.ai/)
78
85
79
86
2.**Blockchain Access**:
87
+
80
88
-[Alchemy API Key](https://www.alchemy.com/) (required for blockchain data)
81
89
- RPC URLs from [Alchemy](https://www.alchemy.com/) or [Infura](https://www.infura.io/) or another RPC provider of choice
82
90
@@ -87,6 +95,7 @@ Before running the framework, you'll need to obtain several API keys:
87
95
### 3. Environment Configuration
88
96
89
97
1. Create your environment file:
98
+
90
99
```bash
91
100
cp .env.example .env
92
101
```
@@ -96,37 +105,44 @@ cp .env.example .env
96
105
#### Required environment variables:
97
106
98
107
LLM Configuration (at least one required):
108
+
99
109
-`ANTHROPIC_API_KEY`: Your Anthropic API key if using Claude models (default)
100
110
-`OPENAI_API_KEY`: Your OpenAI API key if using GPT models
101
111
- For any other provider ensure to follow the same pattern
102
112
103
113
Blockchain Access:
114
+
104
115
-`ALCHEMY_API_KEY`: Your Alchemy API key for accessing blockchain data
105
116
106
117
Ethereum Configuration (only if using Ethereum):
118
+
107
119
-`ETH_RPC_URL`: RPC endpoint URL for connecting to Ethereum network
108
120
-`ETH_WALLET_ADDRESS`: Your Ethereum wallet address for trading
109
121
-`ETH_PRIVATE_KEY`: Private key for your Ethereum wallet
110
122
111
123
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
113
126
-`BASE_WALLET_ADDRESS`: Your Base wallet address for trading
114
127
-`BASE_PRIVATE_KEY`: Private key for your Base wallet
115
128
116
129
#### Optional configurations:
117
130
118
131
Testing environment variables:
132
+
119
133
-`ETH_SEPOLIA_RPC_URL`: Your Sepolia testnet RPC endpoint URL
120
134
-`ETH_SEPOLIA_WALLET_ADDRESS`: Your Ethereum wallet address for Sepolia testnet
121
135
-`ETH_SEPOLIA_PRIVATE_KEY`: Private key for your Sepolia testnet wallet
122
136
123
137
Notification settings:
138
+
124
139
-`TELEGRAM_BOT_TOKEN`: Required for sending alerts via Telegram bot
125
140
-`TELEGRAM_CHAT_ID`: Required chat ID for receiving Telegram alerts
126
141
-`TELEGRAM_SERVER_IP`: IP address for Telegram server (defaults to 0.0.0.0)
127
142
-`TELEGRAM_SERVER_PORT`: Port for Telegram server (defaults to 8000)
128
143
129
144
Logging configuration:
145
+
130
146
-`LOG_LEVEL`: Sets logging verbosity level (defaults to INFO)
131
147
-`LOG_FORMAT`: Custom format for log messages (default: "%(asctime)s - %(name)s - %(levelname)s - %(message)s")
132
148
@@ -142,9 +158,10 @@ Logging configuration:
142
158
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`.
143
159
144
160
Key configuration sections:
161
+
145
162
-**Network Environments**: Production and test network configurations
146
163
-**Trading Venues**: Supported DEXs with their supported pairs and settings for each chain
147
-
-**Chain Configuration**:
164
+
-**Chain Configuration**:
148
165
- Chain-specific wallet and RPC settings
149
166
- Token addresses and decimals
150
167
- Gas settings and transaction parameters
@@ -159,6 +176,7 @@ See [examples/README.md](examples/README.md) for more information about usage ex
159
176
## Development
160
177
161
178
### Running Tests
179
+
162
180
```bash
163
181
# Run all tests
164
182
make all-tests
@@ -171,6 +189,7 @@ make integration-tests # Requires API keys to be specified
171
189
### Code Quality
172
190
173
191
The project uses:
192
+
174
193
- Black for code formatting
175
194
- isort for import sorting
176
195
- ruff for linting
@@ -187,6 +206,7 @@ poetry run mypy .
187
206
```
188
207
189
208
or use Makefile shortcuts:
209
+
190
210
```bash
191
211
make dev-lint
192
212
```
@@ -199,6 +219,8 @@ For security concerns, please review our [Security Policy](SECURITY.md). We take
199
219
200
220
Need help? Check out our [Support Guide](SUPPORT.md) for ways to get assistance.
201
221
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
+
202
224
## Contributing
203
225
204
226
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:
218
240
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.
219
241
220
242
4.**User Responsibility**: Users are solely responsible for:
243
+
221
244
- Understanding the risks involved
222
245
- Conducting their own due diligence
223
246
- Securing their private keys and funds
224
247
- Testing thoroughly on testnets before using real funds
225
248
- Setting appropriate risk management parameters
226
249
227
250
5.**No Warranty**: The software is provided "AS IS", without warranty of any kind, express or implied. The developers and contributors:
251
+
228
252
- Make no representations about its suitability for any purpose
229
253
- Take no responsibility for any financial losses incurred
230
254
- 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
236
260
## License
237
261
238
262
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
This project uses [GitHub Issues](https://github.com/chain-ml/alphaswarm/issues)
5
4
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
7
6
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