added readme

README.md

@@ -1 +1,56 @@
-# foreignthon
+# ForeignThon
+
+Write Python in any human language.
+
+ForeignThon transpiles `.es.py`, `.ta.py` and more into standard Python — keywords, builtins, exceptions, all translated. Errors come back in your language too.
+
+```python
+# main.es.py
+def saludar(nombre):
+    retornar f"Hola, {nombre}!"
+
+para i en dist(3):
+    escribir(saludar(f"mundo {i}"))
+```
+
+```bash
+fpy run main.es.py
+# Hola, mundo 0!
+# Hola, mundo 1!
+# Hola, mundo 2!
+```
+
+## Install
+
+```bash
+pip install foreignthon      # Core 
+pip install foreignthon-es   # Spanish
+pip install foreignthon-ta   # Tamil
+```
+
+## Quick start
+
+```bash
+fpy new myproject --lang es
+cd myproject
+fpy run src/main.es.py
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `fpy new <name> --lang <code>` | Scaffold a new project |
+| `fpy run <file>` | Transpile and run |
+| `fpy compile <file>` | Transpile to `.compiled.py` |
+| `fpy decompile <file> --lang <code>` | Convert Python back to a language |
+| `fpy check <file>` | Validate without running |
+
+## Documentation
+
+→ [fpy.keshavanand.net](https://foreignthon.keshavanand.net)
+
+## License
+
+GPL v3
+