neura-lang/README.md

Neura - AI-First programming language that accelerates development 100×

# Neura Programming Language

[![Version](https://img.shields.io/badge/version-0.1.0--alpha.3-blue)](https://www.npmjs.com/package/neura-lang)
[![AI-First](https://img.shields.io/badge/paradigm-AI%20First-purple)]()
[![License](https://img.shields.io/badge/license-MIT-green)]()

Neura es un lenguaje de programación diseñado con un paradigma **AI-First** para acelerar el desarrollo hasta **100×**.

## Instalación

### Usando npm (recomendado)

```bash
# Instalación global (recomendada)
npm install -g neura-lang

# Verificar instalación
neura --version
```

### Usando Homebrew (macOS)

```bash
# Instalación vía Homebrew
brew tap neura-lang/neura
brew install neura

# Verificar instalación
neura --version
```

## Características AI-First

Neura incluye características AI-First que aceleran el desarrollo:

### 1. Watch & Reload System
- Permite hot-reload de módulos cuando se detectan cambios en archivos
- Accesible mediante CLI: `neura watch`

### 2. Package Manager (neurapkg)
- Gestiona dependencias y módulos en el ecosistema Neura
- Sistema de versiones semántico: `neura pkg add auth.jwt@^1.0.0`

### 3. AI Plugin
- Anotaciones como `@ai.optimize` para sugerencias y optimizaciones de código
- Compatible con múltiples modelos de IA (remoto, local, embebido)

### 4. Code Generation System
- **Directivas `@generate`**: Generación automática en base a especificaciones declarativas
- **Scaffolding System**: Generación rápida de estructuras de proyecto
- **Macros Parametrizables**: Plantillas de código reutilizables con parámetros dinámicos

## Uso Básico

### Crear un nuevo proyecto

```bash
neura new mi-proyecto
cd mi-proyecto
```

### Ejecutar código Neura

```bash
neura run main.neura
```

### Compilar código Neura

```bash
neura compile main.neura --target javascript --output main.js
```

### Hot-Reload (Watch)

```bash
neura watch main.neura
```

### Ver características AI-First

```bash
neura ai
```

## Licencia

MIT