Welcome to the AIsa Cookbook! This repository contains a collection of standalone, ready-to-run recipes for building AI agents and automated workflows using the AIsa.one ecosystem.
Each recipe is designed as a completely independent project. You can copy any folder out of this repository, install its specific requirements, configure your API keys, and run it immediately!
Below is a summary of the fully-functional agents and scripts currently available in the python/ directory:
| Recipe | Description | AIsa Features Used |
|---|---|---|
| 01. Viral X/Twitter Thread Bot | Automates social media growth by finding the latest engaging facts on a topic and crafting a viral 5-part Twitter thread. | LLM Gateway (gpt-4o), Tavily Web Search |
| 02. Automated Investment Memos | Transforms hours of manual equity research into an automated investment memo with live data synthesis. | Live Financial Metrics, Earnings Press Releases, News, LLM Gateway |
| 03. Academic Fact Checker | Rigorous researcher that searches peer-reviewed studies to mathematically fact-check any claim and generate markdown reports. | Smart Search API, LLM Gateway (gpt-4o) |
| 04. Trend-to-Video Creator | Fetches top real-time trends from X, crafts cinematic prompts, and generates AI video automatically. | Twitter API, AIGC Video Synthesis, LLM Gateway |
| 05. CEO/CFO Trade Monitor | Monitors SEC filings for specific stock tickers to fetch insider trades, then analyzes structural buying or dumping by executives. | Insider Trades API, LLM Gateway (gpt-4o) |
| 06. Crypto Sentiment Trader | Fetches live crypto prices and breaking news, then synthesizes fear & greed sentiment to make Buy/Sell/Hold decisions. | Crypto Prices Snapshot, News API, LLM Gateway |
To run any of the recipes in this cookbook:
-
Clone the repository:
git clone https://github.com/AIsa-team/aisa-cookbook.git cd aisa-cookbook -
Navigate to the setup folder:
cd python/01_social_automator -
Install dependencies:
pip install -r requirements.txt
-
Configure your API keys: Get your API key from AIsa.one and add it to your environment.
cp .env.example .env # Edit .env and insert: AISA_API_KEY="sk-..." -
Run the agent: Consult the
README.mdinside the specific recipe's folder for exact run commands (e.g.,python bot.pyorpython analyst.py).
- Official Documentation: docs.aisa.one
- Main Website: AIsa.one
- Get API Key: Marketplace
Contributions are always welcome! If you have a powerful use case or a minimal agent recipe built on top of AIsa, please open a PR.