Skip to content

Axelfernandes/axel_cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ Axel — The AI Coding Assistant for Cloud Native Teams

GitHub license FastAPI Next.js GCP Cloud Run

Axel is a premium, model-agnostic AI coding assistant designed for modern development workflows. It integrates deeply with GCP Vertex AI (Mistral/Codestral) while providing a unified interface for Cerebras, Anthropic, Gemini, and OpenAI.


✨ Key Features

  • 🌓 Modern Dashboard: A sleek, high-performance web interface built with Next.js and Tailwind CSS.
  • 💻 Monaco Editor: Full-featured code editing experience with syntax highlighting for dozens of languages.
  • Ultra-Fast Streaming: Real-time token streaming via SSE for a responsive chat experience.
  • 🔒 Secure-by-Design: Professional-grade Fernet encryption for all stored API keys.
  • 🤖 Provider Flexible: Built-in support for Cerebras (llama3.1-8b), Vertex AI (Codestral), Gemini 1.5/2.0, Claude 3.5, and GPT-4o.
  • ☁️ Cloud Native: Optimized Docker configurations for zero-config deployments to GCP Cloud Run.

🏗️ Architecture

Axel is architected for scalability and separation of concerns.

graph TD
    User([Developer]) --> Web["Axel Web (Next.js)"]
    User --> CLI["Axel CLI (Python)"]
    Web & CLI -->|REST / SSE| API["Axel Backend (FastAPI)"]
    
    subgraph "AI Providers"
        API -->|Vertex SDK| Vertex["Vertex AI (Mistral)"]
        API -->|REST| Gemini["Google Gemini"]
        API -->|SDK| Cerebras["Cerebras Cloud"]
        API -->|SDK| Others["OpenAI / Anthropic"]
    end
    
    API --- DB[(SQLite + encryption)]
Loading

🚀 Getting Started

1. Backend Setup

The heart of Axel. Handles encryption, session management, and AI provider abstraction.

cd backend
# 1. Update .env.cloudrun with your keys
# 2. Deploy instantly
./deploy.sh

2. Web Dashboard

A premium web interface for browsing repositories and chatting with models.

cd axel-web
npm install
npm run dev -- --port 3501

3. Terminal CLI

For the minimalists. Access Axel's brain directly from your shell.

cd cli
pip install .
axel chat

📂 Project Structure

Directory Purpose
backend/ FastAPI service, DB models, and AI client logic.
axel-web/ Next.js frontend with Monaco editor & streaming chat.
cli/ Lightweight Python CLI for terminal-based interactions.

🛠️ Tech Stack

  • Frontend: Next.js 14, Tailwind CSS, Monaco Editor, React Hot Toast.
  • Backend: FastAPI, SQLAlchemy, Pydantic, cryptography (Fernet).
  • Hosting: GCP Cloud Run (Backend), Vercel (Frontend).
  • APIs: GitHub API, Vertex AI, Cerebras, Google GenAI (REST).

Built with ❤️ by the Axel Team

About

Axel CLI: Simple CLI coding agent with GCP Cloud Run backend that swaps Mistral/Codestral models per project via config, no client code changes needed.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors