Metadata-Version: 2.4
Name: CarvusTrain
Version: 1.0.1
Summary: CarvusTrain: A powerful AI development ecosystem — train, deploy, and serve AI models with code generation, grammar understanding, RAG, and agent training.
Keywords: ai,deep-learning,machine-learning,training-framework,nlp,transformers,code-generation,rag,llm,carvustrain,aadil-fazal
Author-email: Aadil Fazal <aadilfazal@github.com>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Code Generators
License-File: LICENSE
Requires-Dist: scikit-learn>=1.0 ; extra == "all"
Requires-Dist: sentence-transformers>=2.2 ; extra == "all"
Requires-Dist: pytest>=7.0 ; extra == "dev"
Requires-Dist: pytest-cov>=4.0 ; extra == "dev"
Requires-Dist: black>=23.0 ; extra == "dev"
Requires-Dist: flake8>=6.0 ; extra == "dev"
Requires-Dist: mypy>=1.0 ; extra == "dev"
Requires-Dist: torch>=2.0.0 ; extra == "torch"
Requires-Dist: pyyaml>=6.0 ; extra == "yaml"
Project-URL: Changelog, https://github.com/AadilFazal/CarvusTrain/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/AadilFazal/CarvusTrain/tree/main/docs
Project-URL: Homepage, https://github.com/AadilFazal/CarvusTrain
Project-URL: Repository, https://github.com/AadilFazal/CarvusTrain.git
Provides-Extra: all
Provides-Extra: dev
Provides-Extra: torch
Provides-Extra: yaml

<p align="center">
  <img src="logo.png" width="260" alt="CarvusTrain Logo"/>
</p>

<h1 align="center">
  ⚡ CarvusTrain
</h1>

<p align="center">
  <b>The AI Development Ecosystem</b><br>
  Train • Build • Deploy • Evolve
</p>

<p align="center">
  <img src="https://img.shields.io/badge/AI-Development-ff7f50?style=for-the-badge&logo=python&logoColor=white"/>
  <img src="https://img.shields.io/badge/Python-3.9+-3776AB?style=for-the-badge&logo=python&logoColor=white"/>
  <img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge"/>
  <img src="https://img.shields.io/pypi/v/CarvusTrain?style=for-the-badge&logo=pypi"/>
</p>

<p align="center">
  <a href="https://github.com/AadilFazal/CarvusTrain">
    <img src="https://img.shields.io/github/stars/AadilFazal/CarvusTrain?style=for-the-badge"/>
  </a>
  <a href="https://pypi.org/project/CarvusTrain/">
    <img src="https://img.shields.io/pypi/dm/CarvusTrain?style=for-the-badge"/>
  </a>
</p>


---

<p align="center">
  <img src="https://readme-typing-svg.herokuapp.com?font=JetBrains+Mono&size=22&duration=3000&pause=700&color=FF7F50&center=true&vCenter=true&width=700&lines=Build+your+own+AI+models;Generate+real+production+code;Create+intelligent+agents;Deploy+AI+as+APIs"/>
</p>


# 🚀 What is CarvusTrain?

> **CarvusTrain is not just an AI trainer.**
>
> It is a complete AI engineering ecosystem designed to create, train, deploy, and evolve intelligent systems.

Built completely in Python with **zero mandatory dependencies**, CarvusTrain provides:

- 🧠 AI model creation
- 💻 Real code generation
- 📚 Knowledge learning
- 🤖 Autonomous agents
- 🌐 API deployment
- 🧬 Model exporting


---

# ✨ Features


## 🧠 Advanced AI Core

<table>
<tr>
<td width="50%">

### Model Builder

Create AI architectures:

- Transformer
- Neural Networks
- CNN
- RNN
- LSTM
- Custom models

</td>

<td width="50%">

### Intelligence Engine

Includes:

- Memory system
- Personality engine
- Context tracking
- Learning validation
- Plugin architecture

</td>
</tr>
</table>


---

# 💻 AI Code Generation Engine

<p align="center">
  <img src="https://media.giphy.com/media/qgQUggAC3Pfv687qPC/giphy.gif" width="500"/>
</p>


Generate real algorithms in:

| Language | Support |
|-|-|
| Python | ✅ |
| JavaScript | ✅ |
| TypeScript | ✅ |
| Java | ✅ |
| C++ | ✅ |
| Rust | ✅ |
| Go | ✅ |
| Kotlin | ✅ |
| Swift | ✅ |
| Bash | ✅ |
| Ruby | ✅ |
| PHP | ✅ |
| R | ✅ |
| Scala | ✅ |


Example:

```python
from carvustrain import Model

ai = Model(
    name="Carvus",
    architecture="transformer"
)

ai.learn(
    "Python is a programming language"
)

answer = ai.ask(
    "What is Python?"
)

print(answer)
```


---

# 🧬 Learning System

CarvusTrain can:

```
Input Data
     |
     ▼
Knowledge Engine
     |
     ▼
Semantic Memory
     |
     ▼
AI Reasoning
     |
     ▼
Improved Responses
```


Features:

- TF-IDF semantic search
- Knowledge retention
- Grammar understanding
- Learning validation
- Context awareness


---

# 🤖 Agent Framework

Create specialized AI agents:


```
                 Carvus Agent System

                        AI

                        |
        --------------------------------
        |              |               |
     Planner        Coder          Researcher

                        |
                        ▼

              Automated Solutions
```


Supports:

- Goal based training
- Multi-agent teams
- Custom workflows
- Auto optimization


---

# 🌐 Deploy Anywhere


Turn your model into an API:

```python
model.serve(
    port=8000
)
```


Endpoints:

```
POST /
GET  /info
```


Export formats:

```
.ct
.json
.bin
.onnx
.gguf
```


---

# ⚡ CLI Experience


```bash
carvustrain create my-ai

carvustrain train --data dataset.txt

carvustrain chat --model my.ct

carvustrain serve --port 8000

carvustrain export --format gguf
```


---

# 📦 Installation


```bash
git clone https://github.com/AadilFazal/CarvusTrain.git

cd CarvusTrain

pip install -e .
```


Optional AI acceleration:

```bash
pip install scikit-learn

pip install sentence-transformers
```


---

# 🏗️ Architecture


```
CarvusTrain

├── Model Engine
├── Memory System
├── Knowledge Base
├── Inference Engine
├── Trainer
├── Agent Framework
├── Export System
├── API Server
└── CLI
```


---

# 🛠️ Roadmap


✅ AI Model Builder  
✅ Code Generation  
✅ Knowledge System  
✅ REST API  
✅ Agent Framework  


Coming:

⬜ GPU Training Engine  
⬜ Distributed Training  
⬜ Visual AI Studio  
⬜ Carvus Cloud  
⬜ Neural Architecture Search  


---

# 🌌 Vision

<p align="center">

<b>
"Give everyone the power to build intelligent systems."
</b>

</p>


CarvusTrain aims to become a complete open AI engineering platform where developers can create, train, and deploy the next generation of AI.


---

<h3 align="center">
Made with ⚡ by Aadil Fazal
</h3>

<p align="center">
<img src="https://capsule-render.vercel.app/api?type=waving&color=ff7f50&height=120&section=footer"/>
</p>
