Add Elixir documentation to getting-started and AI integration guides

Author: benoitc

docs/ai-integration.md

@@ -672,6 +672,71 @@ cosine_sim(A, B) ->
     Dot / (NormA * NormB).
 ```
 
+## Using from Elixir
+
+All AI examples work seamlessly from Elixir:
+
+```elixir
+# Start erlang_python
+{:ok, _} = Application.ensure_all_started(:erlang_python)
+
+# Activate venv with AI libraries
+:ok = :py.activate_venv("/path/to/ai_venv")
+
+# Generate embeddings using ai_helpers module
+{:ok, embeddings} = :py.call(:ai_helpers, :embed_texts, [
+  ["Elixir is functional", "Python does ML", "BEAM is concurrent"]
+])
+
+# Semantic search
+{:ok, query_emb} = :py.call(:ai_helpers, :embed_single, ["concurrent programming"])
+
+# Calculate similarity in Elixir
+similarities = Enum.zip(texts, embeddings)
+|> Enum.map(fn {text, emb} -> {text, cosine_similarity(query_emb, emb)} end)
+|> Enum.sort_by(fn {_, score} -> score end, :desc)
+```
+
+### Parallel AI with BEAM Processes
+
+```elixir
+# Register parallel embedding function
+:py.register_function(:parallel_embed, fn [texts] ->
+  parent = self()
+
+  refs = Enum.map(texts, fn text ->
+    ref = make_ref()
+    spawn(fn ->
+      {:ok, emb} = :py.call(:ai_helpers, :embed_single, [text])
+      send(parent, {ref, emb})
+    end)
+    ref
+  end)
+
+  Enum.map(refs, fn ref ->
+    receive do
+      {^ref, result} -> result
+    after
+      30_000 -> {:error, :timeout}
+    end
+  end)
+end)
+```
+
+### Running the Elixir AI Example
+
+```bash
+# Full Elixir example with AI integration
+elixir --erl "-pa _build/default/lib/erlang_python/ebin" examples/elixir_example.exs
+```
+
+The example demonstrates:
+- Basic Python calls from Elixir
+- Data type conversion
+- Registering Elixir callbacks for Python
+- Parallel processing (10x speedup)
+- Semantic search with embeddings
+
 ## See Also
 
 - [Getting Started](getting-started.md) - Basic usage

docs/getting-started.md

@@ -139,9 +139,82 @@ py_semaphore:current().         %% Currently executing
 
 See [Scalability](scalability.md) for details on execution modes and performance tuning.
 
+## Using from Elixir
+
+erlang_python works seamlessly with Elixir. The `:py` module can be called directly:
+
+```elixir
+# Start the application
+{:ok, _} = Application.ensure_all_started(:erlang_python)
+
+# Call Python functions
+{:ok, 4.0} = :py.call(:math, :sqrt, [16])
+
+# Evaluate expressions
+{:ok, result} = :py.eval("2 + 2")
+
+# With variables
+{:ok, 100} = :py.eval("x * y", %{x: 10, y: 10})
+
+# Call with keyword arguments
+{:ok, json} = :py.call(:json, :dumps, [%{name: "Elixir"}], %{indent: 2})
+```
+
+### Register Elixir Functions for Python
+
+```elixir
+# Register an Elixir function
+:py.register_function(:factorial, fn [n] ->
+  Enum.reduce(1..n, 1, &*/2)
+end)
+
+# Call from Python
+{:ok, 3628800} = :py.eval("__import__('erlang').call('factorial', 10)")
+
+# Cleanup
+:py.unregister_function(:factorial)
+```
+
+### Parallel Processing with BEAM
+
+```elixir
+# Register parallel map using BEAM processes
+:py.register_function(:parallel_map, fn [func_name, items] ->
+  parent = self()
+
+  refs = Enum.map(items, fn item ->
+    ref = make_ref()
+    spawn(fn ->
+      result = apply_function(func_name, item)
+      send(parent, {ref, result})
+    end)
+    ref
+  end)
+
+  Enum.map(refs, fn ref ->
+    receive do
+      {^ref, result} -> result
+    after
+      5000 -> {:error, :timeout}
+    end
+  end)
+end)
+```
+
+### Running the Elixir Example
+
+A complete working example is available:
+
+```bash
+elixir --erl "-pa _build/default/lib/erlang_python/ebin" examples/elixir_example.exs
+```
+
+This demonstrates basic calls, data conversion, callbacks, parallel processing (10x speedup), and AI integration.
+
 ## Next Steps
 
 - See [Type Conversion](type-conversion.md) for detailed type mapping
 - See [Streaming](streaming.md) for working with generators
 - See [Memory Management](memory.md) for GC and debugging
 - See [Scalability](scalability.md) for parallelism and performance
+- See [AI Integration](ai-integration.md) for ML/AI examples