https://github.com/frankiefab100/crypto-ai-agent
An AI agent that leverages the ADK TypeScript library and tools to provide real-time cryptocurrency prices and market data, and also deliver the latest curated news articles from Coindesk in the terminal
https://github.com/frankiefab100/crypto-ai-agent
adk adk-ts ai ai-agents llm
Last synced: about 1 month ago
JSON representation
An AI agent that leverages the ADK TypeScript library and tools to provide real-time cryptocurrency prices and market data, and also deliver the latest curated news articles from Coindesk in the terminal
- Host: GitHub
- URL: https://github.com/frankiefab100/crypto-ai-agent
- Owner: frankiefab100
- License: mit
- Created: 2025-07-04T21:57:43.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-07-09T21:50:09.000Z (3 months ago)
- Last Synced: 2025-07-10T06:51:13.071Z (3 months ago)
- Topics: adk, adk-ts, ai, ai-agents, llm
- Language: TypeScript
- Homepage:
- Size: 66.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Crypto AI Agent
A conversational AI agent for cryptocurrency insights, powered by [`@iqai/adk`](https://github.com/IQAICOM/adk-ts). This agent can answer crypto-related questions, fetch a coin/token price, market cap, volume or category and retrieve the latest news from CoinDesk directly from your terminal.
## Features
- **Conversational CLI**: Ask multiple questions in a single session without need to restart the process.
- **Crypto Data Queries**: Get real-time prices, market cap, category and volume for cryptocurrencies/tokens.
- **Crypto News**: Fetch the latest curated news or specific number of articles from [CoinDesk](https://coindesk.com).
## Development Tools
- **Husky**: Git hooks for code quality
- **Biome**: Linting and formatting
- **GitHub Actions**: CI/CD pipeline
- **PNPM**: Fast package manager
## Get Started
### Prerequisites
- Node.js 18+ and PNPM installed
- LLM Model API Key (e.g GPT, Gemini, Claude, etc)
- [CoinGecko API Key](https://www.coingecko.com/en/developers)
- [CoinDesk API Key](https://developers.coindesk.com/documentation/data-api/introduction)
Clone the repository:
```bash
git clone https://github.com/frankiefab100/crypto-ai-agent.git
cd crypto-ai-agent
```
Install dependencies:
```bash
pnpm install
```
Run the agent:
```bash
export GOOGLE_API_KEY=your-llm-model-api-key
npx tsx src/index.ts
```
## Environment Variables Setup
Create a `.env` file in the root directory with the necessary variables and fill in your credentials:
```env
LLM_MODEL=your-llm-model # Large Language model (e.g., `gemini-2.5-flash`)
GOOGLE_API_KEY=your-google-api-key # Gemini LLM Model API key
COINGECKO_API_KEY=your-coingecko-api-key # Coingecko Demo plan API key
COINDESK_API_KEY=your-coindesk-api-key # Coindesk Data API key
```
## Project Structure
The main agent code lives in `src/index.ts`. Agents and their tools are organized as follows:
```
├── src/
│ ├── agent/
│ │ ├── index.ts # AI agent configuration
│ │ └── tools/
│ │ ├── crypto-data-tool.ts # Cryptocurrency data tool
│ │ └── coindesk-news-tool.ts # Coindesk news/articles tool
│ ├── lib/
| | ├── env.ts # Environment variables schema
│ │ ├── types.ts # Type definitions
│ │ └── utils.ts # Utility functions
│ └── index.ts # CLI logic for user interaction
```
## Contributing
1. Fork the repository
2. Create a feature branch: `git checkout -b feature/your-feature`
3. Make your changes and commit: `git commit -m "Add your feature"`
4. Push to your fork: `git push origin feature/your-feature`
5. Open a Pull Request
## License
This project is licensed under the [MIT License](./LICENSE) .
## Resources
- [ADK Typescript Library](https://adk.iqai.com/)
- [CoinGecko Public API](https://docs.coingecko.com/v3.0.1/reference)
- [CoinDesk Data API Docs](https://developers.coindesk.com/documentation/data-api/introduction)