├── LICENSE ├── README.md ├── config.json ├── docs ├── api_reference.md ├── configuration.md ├── installation.md ├── portfolio.md └── usage.md ├── requirement.txt └── src ├── agents ├── agent_base.py ├── momenium_agent.py ├── portfolio_manager.py └── sentiment_agent.py ├── app.py ├── examples ├── multi_model_example.json ├── portfolio_example.json ├── portfolio_execution_example.py ├── sample_agent.json └── solana_execution_example.json ├── frontend-portfolio ├── api.js ├── dashboard.html ├── index.html ├── portfolio.js ├── styles.css └── upload.html ├── models ├── decision_engine.py ├── sentiment_analyzer.py └── trade_executor.py ├── tests ├── test_agents.py ├── test_models.py ├── test_portfolio.py └── test_utils.py └── utils ├── ai_model_adapter.py ├── json_generator.py ├── logger.py ├── portfolio_handler.py └── solana_connector.py /LICENSE: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/LICENSE -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # OuTre: AI Trading Agent Framework 2 | 3 | OuTre is a fully modular AI Trading Agent Framework designed for **Solana-based trading automation**. It enables traders to **create AI agents**, **execute strategies**, and **manage portfolios** via JSON configurations. 4 | 5 | ### ✨ Key Features 6 | - **Customizable AI Agents** – Tailor trading bots to your style & risk. 7 | - **Multi-Model AI Compatibility** – Works with OpenAI, Anthropic, Solana Web3. 8 | - **Solana Execution** – Direct on-chain execution with minimal latency. 9 | - **Portfolio Management** – Upload agent JSONs to OuTre.app or run locally. 10 | 11 | ### 🚀 Installation 12 | Refer to [docs/installation.md](docs/installation.md) for setup. 13 | 14 | ### 🔧 Usage 15 | 1. Configure your agent in `config.json` 16 | 2. Run your agent: 17 | ```bash 18 | python src/app.py 19 | -------------------------------------------------------------------------------- /config.json: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/config.json -------------------------------------------------------------------------------- /docs/api_reference.md: -------------------------------------------------------------------------------- 1 | # 📡 OuTre API Reference 2 | 3 | ## 🔹 Upload Agent JSON 4 | **POST** `/upload` 5 | - Uploads a new agent configuration. 6 | - Example: 7 | ```json 8 | { 9 | "agent_name": "MomentumTrader", 10 | "strategy": "Momentum", 11 | "risk_tolerance": "Moderate" 12 | } 13 | 14 | 🔹 Get Portfolio Data 15 | GET /portfolio?wallet={wallet_address} 16 | Returns the user’s portfolio data. 17 | 🔹 Execute Trade 18 | POST /execute_trade 19 | Executes a trade on Solana based on AI agent logic. 20 | Refer to the full API documentation for authentication and more endpoints. 21 | yaml 22 | CopyEdit 23 | 24 | --- 25 | 26 | ### ✅ **Final Notes** 27 | 1. **Users can upload JSON to OuTre.app** or **run locally using the provided portfolio dashboard**. 28 | 2. **Supports multiple AI models (OpenAI, Anthropic, Solana Web3) & blockchain execution**. 29 | 3. **Front-end included for users who want to self-host**. 30 | 4. **Modular design ensures easy expansion**. 31 | 32 | --- 33 | 34 | This is the **complete GitHub repository framework**—just copy and paste it to create a **fully functional OuTre AI Trading Agent repo**! 🚀 Let me know if you need refinements. 35 | -------------------------------------------------------------------------------- /docs/configuration.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/docs/configuration.md -------------------------------------------------------------------------------- /docs/installation.md: -------------------------------------------------------------------------------- 1 | API Integration 2 | 3 | 🔗 API & Integration 4 | Refer to docs/api_reference.md for API integration. 5 | 📜 License 6 | MIT License. 7 | yaml 8 | CopyEdit 9 | 10 | --- 11 | 12 | ## 📄 **Installation Guide (docs/installation.md)** 13 | ```markdown 14 | # 📌 Installation Guide 15 | 16 | ## ✅ Prerequisites 17 | - Python 3.8+ 18 | - Node.js (for frontend) 19 | - Solana CLI 20 | - API keys for OpenAI, Anthropic (optional) 21 | 22 | ## 🔨 Steps 23 | 1. **Clone Repo** 24 | ```bash 25 | git clone https://github.com/your-repo/ouTre-framework.git 26 | cd ouTre-framework 27 | 28 | Install Python Dependencies 29 | bash 30 | CopyEdit 31 | pip install -r requirements.txt 32 | 33 | 34 | Run the AI Trading Agent 35 | bash 36 | CopyEdit 37 | python src/app.py 38 | 39 | 40 | Run the Frontend Portfolio 41 | bash 42 | CopyEdit 43 | cd frontend_portfolio 44 | python -m http.server 45 | 46 | 47 | pgsql 48 | CopyEdit 49 | 50 | --- 51 | 52 | ## 🧩 **Example Agent JSON (examples/sample_agent.json)** 53 | ```json 54 | { 55 | "agent_name": "MomentumTrader", 56 | "agent_description": "An AI agent optimized for momentum trading.", 57 | "model_preferences": { 58 | "primary_model": "OpenAI", 59 | "fallback_model": "Anthropic", 60 | "execution_environment": "Solana" 61 | }, 62 | "trading_strategy": { 63 | "type": "Momentum", 64 | "risk_tolerance": "Moderate", 65 | "stop_loss": 0.05, 66 | "take_profit": 0.20, 67 | "position_sizing": "Dynamic", 68 | "time_horizon": "Short-Term" 69 | }, 70 | "market_awareness": { 71 | "data_sources": ["Pyth Network", "TradingView API"], 72 | "technical_indicators": ["RSI", "MACD"], 73 | "sentiment_analysis": true 74 | }, 75 | "execution_logic": { 76 | "max_trades_per_day": 10, 77 | "execution_speed": "High", 78 | "order_types": ["Market", "Limit"] 79 | } 80 | } 81 | -------------------------------------------------------------------------------- /docs/portfolio.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/docs/portfolio.md -------------------------------------------------------------------------------- /docs/usage.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/docs/usage.md -------------------------------------------------------------------------------- /requirement.txt: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/requirement.txt -------------------------------------------------------------------------------- /src/agents/agent_base.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/agents/agent_base.py -------------------------------------------------------------------------------- /src/agents/momenium_agent.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/agents/momenium_agent.py -------------------------------------------------------------------------------- /src/agents/portfolio_manager.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/agents/portfolio_manager.py -------------------------------------------------------------------------------- /src/agents/sentiment_agent.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/agents/sentiment_agent.py -------------------------------------------------------------------------------- /src/app.py: -------------------------------------------------------------------------------- 1 | from utils.solana_connector import SolanaConnector 2 | from agents.momentum_agent import MomentumAgent 3 | 4 | def main(): 5 | agent_config = MomentumAgent.load_config("config.json") 6 | solana = SolanaConnector(agent_config["wallet_address"]) 7 | agent = MomentumAgent(solana, agent_config) 8 | agent.run() 9 | 10 | if __name__ == "__main__": 11 | main() 12 | -------------------------------------------------------------------------------- /src/examples/multi_model_example.json: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/examples/multi_model_example.json -------------------------------------------------------------------------------- /src/examples/portfolio_example.json: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/examples/portfolio_example.json -------------------------------------------------------------------------------- /src/examples/portfolio_execution_example.py: -------------------------------------------------------------------------------- 1 | import requests 2 | 3 | wallet_address = "YourWalletAddress" 4 | api_url = f"https://api.outre.app/portfolio?wallet={wallet_address}" 5 | 6 | response = requests.get(api_url) 7 | portfolio_data = response.json() 8 | 9 | print("Your Portfolio Overview:", portfolio_data) 10 | -------------------------------------------------------------------------------- /src/examples/sample_agent.json: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/examples/sample_agent.json -------------------------------------------------------------------------------- /src/examples/solana_execution_example.json: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/examples/solana_execution_example.json -------------------------------------------------------------------------------- /src/frontend-portfolio/api.js: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/frontend-portfolio/api.js -------------------------------------------------------------------------------- /src/frontend-portfolio/dashboard.html: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/frontend-portfolio/dashboard.html -------------------------------------------------------------------------------- /src/frontend-portfolio/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | OuTre Portfolio 5 | 6 | 7 | 8 |

OuTre AI Portfolio Manager

9 | 10 | 11 |
12 | 13 | 14 | 15 | 16 | -------------------------------------------------------------------------------- /src/frontend-portfolio/portfolio.js: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/frontend-portfolio/portfolio.js -------------------------------------------------------------------------------- /src/frontend-portfolio/styles.css: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/frontend-portfolio/styles.css -------------------------------------------------------------------------------- /src/frontend-portfolio/upload.html: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/frontend-portfolio/upload.html -------------------------------------------------------------------------------- /src/models/decision_engine.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/models/decision_engine.py -------------------------------------------------------------------------------- /src/models/sentiment_analyzer.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/models/sentiment_analyzer.py -------------------------------------------------------------------------------- /src/models/trade_executor.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/models/trade_executor.py -------------------------------------------------------------------------------- /src/tests/test_agents.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/tests/test_agents.py -------------------------------------------------------------------------------- /src/tests/test_models.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/tests/test_models.py -------------------------------------------------------------------------------- /src/tests/test_portfolio.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/tests/test_portfolio.py -------------------------------------------------------------------------------- /src/tests/test_utils.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/tests/test_utils.py -------------------------------------------------------------------------------- /src/utils/ai_model_adapter.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/utils/ai_model_adapter.py -------------------------------------------------------------------------------- /src/utils/json_generator.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/utils/json_generator.py -------------------------------------------------------------------------------- /src/utils/logger.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/utils/logger.py -------------------------------------------------------------------------------- /src/utils/portfolio_handler.py: -------------------------------------------------------------------------------- 1 | import json 2 | 3 | class PortfolioHandler: 4 | def __init__(self, json_file): 5 | with open(json_file, "r") as f: 6 | self.portfolio = json.load(f) 7 | 8 | def get_total_value(self): 9 | return sum(asset["amount"] * asset["entry_price"] for asset in self.portfolio["assets"]) 10 | 11 | def get_risk_profile(self): 12 | return self.portfolio["performance"]["risk_profile"] 13 | -------------------------------------------------------------------------------- /src/utils/solana_connector.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WesleyCodeMast/OuTre-SDK/5494dd28ad888ecdb0a50722a337ffd9bd4f5362/src/utils/solana_connector.py --------------------------------------------------------------------------------