oratio 0.2.0

ORATIO - Natural language programming in Italian and English

🗣️ ORATIO

The Eloquence of Code

The first true natural language programming language

[!License: MIT](https://opensource.org/licenses/MIT) [!Python 3.8+](https://www.python.org/downloads/) [!Status: Alpha]()

🌐 Website • 📚 Docs • 💬 Community

---

🇮🇹 Parli Italiano. 🇬🇧 Speak English. 🇪🇸 Hablas Español.

The Computer Understands.

---

🇮🇹 Leggi in Italiano

🎯 What is ORATIO?

ORATIO is the first programming language that truly understands your language.

No more syntax to learn. No more cryptic code. You speak, it works.

# This is ORATIO code
Load sales.csv.
Filter rows where amount > 1000.
Calculate the average.
Create a bar chart.
Print "Analysis completed\!"

It works. Really.

---

🚀 Quick Start

Installation

pip install oratio

Your First Program

# Create a file
echo "Print 'Hello World\!'" > hello.ora

# Run it
oratio run hello.ora

Output:

📄 Hello World\!

---

✨ Why ORATIO?

Before (Python)

import pandas as pd
df = pd.read_csv('sales.csv')
filtered = df[df['amount'] > 1000]
mean = filtered['amount'].mean()
print(f"Average: {mean}")

❌ Complex, rigid syntax, you need to know Python

Now (ORATIO)

Load sales.csv.
Filter where amount > 1000.
Calculate the average.
Print the result.

✅ Simple, natural, immediate

---

🌍 Multilingual

ORATIO speaks YOUR language:

# 🇮🇹 Italian
Carica dati.csv e calcola la media.

# 🇬🇧 English  
Load data.csv and calculate the average.

# 🇪🇸 Spanish (Coming Q2 2026)
Carga datos.csv y calcula el promedio.

---

📊 What You Can Do

• ✅ Data analysis (CSV, Excel, JSON)
• ✅ Statistics and calculations
• ✅ Visualizations and charts
• ✅ Filters and transformations
• ✅ Automated reports
• ✅ Workflow automation

Coming Soon:

• 🔜 Databases (SQL, MongoDB)
• 🔜 APIs and Web scraping
• 🔜 Machine Learning
• 🔜 Robot and IoT control

---

📚 Examples

Sales Analysis

Load sales.csv.
Show first 5 rows.
Filter where amount > 1000.
Calculate average of amount column.
Create a bar chart.
Save as report.pdf.

Statistics

Load data.csv.
Calculate mean, median and standard deviation.
Create a histogram.
Print the results.

Automation

For each file in data_folder:
    Load the file.
    Filter where value > 100.
    Save in results_folder.
Print "Processing completed\!"

---

🏗️ Architecture

┌─────────────────────────────────────┐
│  Natural Language                   │
│  "Load data and calculate average"  │
└─────────────────────────────────────┘
              ↓
┌─────────────────────────────────────┐
│  ORATIO Parser                      │
│  (Semantic Understanding)           │
└─────────────────────────────────────┘
              ↓
┌─────────────────────────────────────┐
│  Operations                         │
│  [io.read_csv, math.mean]           │
└─────────────────────────────────────┘
              ↓
┌─────────────────────────────────────┐
│  ORATIO Runtime                     │
│  (Execution Engine)                 │
└─────────────────────────────────────┘
              ↓
┌─────────────────────────────────────┐
│  Result                             │
└─────────────────────────────────────┘

---

🤝 Contributing

ORATIO is open source! Contribute by:

1. New Operations - Add functionality
2. Connectors - Integrate new services
3. Bug Fixes - Improve stability
4. Documentation - Help others
5. Translations - Bring ORATIO to your language

Read CONTRIBUTING.md to get started.

---

📖 Documentation

• Getting Started
• Language Guide
• Operations Reference
• Examples
• FAQ

---

🗺️ Roadmap

✅ Phase 1: Foundation (Q4 2025)

• Core runtime
• Basic operations
• CLI
• Italian support

🚧 Phase 2: Expansion (Q1 2026)

• English support (Beta)
• Cloud platform
• IDE integration
• Plugin system

🔮 Phase 3: Scale (Q2-Q3 2026)

• Spanish, French support
• Database connectors
• ML operations
• Robot/IoT control

🌍 Phase 4: Global (2027+)

• 10+ languages
• Enterprise features
• Marketplace
• Universal standard

---

📜 License

MIT License - see LICENSE

---

👨‍💻 Creator

Manuel Lazzaro

"The future of programming isn't written. It's spoken."

• 🌐 oratio.dev
• 🐦 @oratio_lang
• 💼 LinkedIn
• 💬 Telegram: @manu_lz88

---

🌟 Support the Project

If you like ORATIO:

• ⭐ Star on GitHub
• 🐦 Share on Twitter
• 💬 Join the community
• 🤝 Contribute code

---

📊 Stats

!GitHub stars !GitHub forks !GitHub watchers

---

Made with ❤️ in Italy 🇮🇹

ORATIO - The Eloquence of Code

November 13, 2025 - The Day Programming Changed Forever