Skip to content

Repository files navigation

Navis — AI Decision Agent for Trading

Status: IN DEVELOPMENT — Core features building, not production-ready yet.

Navis is an AI-powered trading decision platform that helps retail traders make better financial decisions in real-time. We remove emotion from trading and provide data-driven, explainable recommendations with confidence scores and risk assessment.


What is Navis?

The Problem

Retail traders face decision paralysis and emotional trading that leads to losses. They need:

  • Data-driven insights (not gut feelings)
  • Explainable decisions (why BUY/SELL/HOLD?)
  • Risk assessment (what's the downside?)
  • Speed (faster than manual analysis)

The Solution

Navis analyzes crypto markets in real-time and provides:

  • BUY / SELL / HOLD recommendations
  • AI Reasoning — why the platform recommends this
  • Confidence Score (0-100%) — how sure is the AI?
  • Risk Level — LOW / MEDIUM / HIGH
  • Price Targets & Stop Losses — where to exit

Current Features (MVP)

Real-time Market Analysis

  • Fetches live crypto prices (BTC, ETH, ADA, SOL, XRP)
  • Analyzes 24h volatility and trading volume

AI-Powered Decisions

  • Claude AI engine analyzes market data
  • Provides actionable trading recommendations
  • Explains reasoning behind each decision

Risk Assessment

  • Confidence scoring (0-100%)
  • Risk level classification
  • Price targets and stop-loss recommendations

Modern UI/UX

  • Clean, professional white theme
  • Real-time dashboard
  • Auto-refresh every 5 minutes

Demo Mode

  • Works without API key (perfect for presentations)
  • Realistic dummy data
  • Production-ready architecture

Roadmap (Upcoming Features)

Phase 2: Enhanced Analysis

  • Portfolio tracking
  • Historical decision accuracy
  • Multi-timeframe analysis (1h, 4h, daily)
  • Technical indicator integration

Phase 3: Advanced Features

  • Risk management alerts
  • Personalized trading profiles
  • Backtesting engine
  • More crypto pairs

Phase 4: Production

  • Auto-trading execution (with safeguards)
  • Real wallet integration
  • Advanced portfolio rebalancing
  • Fraud detection system

Why Navis?

Real-World Impact

1. Removes Emotion from Trading

  • Human traders make 90% of mistakes due to emotion
  • Navis provides discipline through data-driven analysis

2. Solves Decision Paralysis

  • "Should I buy?" → Navis answers: "Yes, because..."
  • Clear, explainable recommendations

3. Speed Advantage

  • AI analyzes markets in milliseconds
  • Humans take hours of research

4. New Category: AI Financial Assistant

  • The future is AI-managed money with human supervision
  • Navis is positioning for that future

Important Notes (Our Philosophy)

What We DON'T Promise

Guaranteed profits 100% accurate predictions Beating the market consistently

Our Honest Take

We provide better decisions based on data We remove emotional trading We offer explainable recommendations We assess real risks

Research shows: Even advanced trading agents have weak returns. We're not trying to predict the future — we're trying to make better decisions with available data.


Quick Start

Prerequisites

  • Node.js 18+
  • npm

Installation

# Clone or download the project
cd "Navis Crypto AI"

# Install dependencies
npm install

# Start dev server
npm run dev

Visit: http://localhost:5174

Demo Mode (No API Key Needed)

  1. Enter any text in the wallet field (e.g., "demo" or "0x123")
  2. See AI trading recommendations with dummy data
  3. Click "Refresh" to re-analyze

API Keys (Optional)

To use real AI analysis instead of demo data:

  1. Get API key from Anthropic
  2. Create .env file:
VITE_ANTHROPIC_API_KEY=sk-ant-your-key-here
  1. Restart dev server

The app automatically switches from demo to production mode based on your API key.


How It Works

User Input (Wallet Address)
    ↓
Market Data Fetch (CoinGecko API)
    ↓
AI Analysis (Claude API)
    ↓
BUY/SELL/HOLD Decision
    ↓
Dashboard Display (with Confidence + Risk)

Project Structure

src/
├── App.tsx                    # Main app wrapper
├── components/
│   ├── WalletConnect.tsx      # Entry screen
│   └── TradingDashboard.tsx   # Main dashboard
├── utils/
│   ├── anthropic.ts           # AI decision engine (with demo mode)
│   └── marketData.ts          # Market data fetcher (CoinGecko)
├── types/
│   └── index.ts               # TypeScript interfaces
├── index.css                  # Tailwind styling
└── main.tsx                   # React entry point

Tech Stack

  • Frontend: React 19 + TypeScript
  • Styling: Tailwind CSS
  • Build: Vite
  • AI Engine: Claude 3.5 Sonnet (Anthropic API)
  • Market Data: CoinGecko API (free, no key needed)

Use Cases

For Individual Traders

  • Get second opinions on trades
  • Reduce emotional decision-making
  • Learn from AI reasoning

For Trading Communities

  • Educational tool
  • Decision validation
  • Risk awareness

For Future (Institutional)

  • Algorithmic trading layer
  • Portfolio management
  • Risk assessment system

The Vision

"We are building an AI system that helps users make better financial decisions in real-time."

What makes Navis different:

  • Explainable decisions (not black-box)
  • Risk-aware (not profit-promise)
  • Retail-focused (not just institutions)
  • Transparent about limitations

Key Insight

The future of finance isn't:

  • Humans vs. Machines
  • Perfect predictions
  • Guaranteed returns

The future of finance IS:

  • AI analyzes → Provides recommendations
  • Humans decide → Make final calls
  • Better discipline → Remove emotion
  • Speed + Accuracy → Data-driven choices

Navis is building for this future.


Development Notes

Current Status

Active Development

  • Core trading decision engine
  • Market analysis
  • UI/UX
  • Demo mode
  • Real API integration

Known Limitations (MVP)

  • Limited to 5 crypto assets
  • No historical data
  • No backtesting
  • No portfolio tracking
  • Demo data is synthetic

What's Coming

  • More crypto pairs
  • Historical accuracy tracking
  • Backtesting engine
  • Risk management alerts
  • Auto-trading (with safeguards)

Contributing

This project is in active development. Contributions welcome!

Areas we need help with:

  • Technical indicator integration
  • Portfolio management features
  • Backtesting engine
  • UI/UX improvements
  • Documentation

Contact & Feedback

Have questions? Found a bug? Ideas for features?

This is a learning project — feedback welcome!


Disclaimer

IMPORTANT: This is an educational/demo tool. Not financial advice.

  • Cryptocurrency trading is highly risky
  • Past performance ≠ future results
  • Never invest money you can't afford to lose
  • Always do your own research (DYOR)
  • Navis provides recommendations, not guarantees

Use at your own risk. We assume no liability for trading losses.


License

MIT License — Free to use and modify


Acknowledgments

Built with:

  • React & TypeScript
  • Anthropic Claude API
  • CoinGecko API
  • Tailwind CSS
  • Vite

Made with for traders who want better decisions

Current Version: 0.1.0 (Beta)
Last Updated: April 2026
Status: In Development

About

AI-powered crypto decision agent that analyzes market data using technical indicators and LLM reasoning to generate buy/sell/hold signals with risk and confidence scoring.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages