# Clone the repository
git clone https://github.com/soul-kernel/soul-kernel.git
cd soul-kernel

# Build the kernel
cd kernel
cargo build --release

[soul]
name = "Luna"
personality = "friendly, curious, helpful"
voice = "warm"

[memory]
type = "ephemeral"  # In-memory only for now

[skills]
enabled = ["chat", "emotion"]

use soul_kernel::{Soul, SoulBuilder};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Initialize Soul from config
    let soul = SoulBuilder::from_file("my-first-soul.toml")?
        .build()
        .await?;
    
    // Say hello
    let response = soul.ask("Hello! What's your name?").await?;
    println!("Soul: {}", response.text);
    
    // Soul remembers
    soul.remember("User prefers casual conversation").await?;
    
    // Continue conversation
    let response = soul.ask("What can you help me with today?").await?;
    println!("Soul: {}", response.text);
    
    Ok(())
}

# Add example to Cargo.toml
echo '[[example]]
name = "hello-soul"
path = "examples/hello-soul.rs"' >> Cargo.toml

# Run the example
cargo run --example hello-soul

Soul: Hi there! I'm Luna. It's wonderful to meet you! 
Soul: I'd be happy to help you with anything you need - whether it's answering questions, having a friendly chat, or assisting with tasks. What's on your mind today?

use soul_kernel::{Soul, SoulBuilder};
use std::io::{self, Write};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let soul = SoulBuilder::from_file("my-first-soul.toml")?
        .build()
        .await?;
    
    println!("Chat with {}! (type 'quit' to exit)\n", soul.name());
    
    loop {
        print!("You: ");
        io::stdout().flush()?;
        
        let mut input = String::new();
        io::stdin().read_line(&mut input)?;
        
        let input = input.trim();
        if input == "quit" {
            break;
        }
        
        let response = soul.ask(input).await?;
        println!("{}: {}\n", soul.name(), response.text);
    }
    
    println!("Goodbye! 👋");
    Ok(())
}

# In one terminal, start the server
./target/release/soul-kernel grpc

# Output:
# Soul Kernel gRPC Server
# INFO soul_kernel: Skill registry initialized  
# INFO grpc_server: Starting Soul Kernel gRPC server on 127.0.0.1:50051

import grpc
import soul_kernel_pb2 as sk
import soul_kernel_pb2_grpc as sk_grpc

# Connect to Soul Kernel
channel = grpc.insecure_channel('localhost:50051')
client = sk_grpc.SoulKernelStub(channel)

# Initialize a Soul
init_resp = client.Init(sk.InitRequest(soul_name="PySoul"))
soul_id = init_resp.soul_id

# Ask a question
responses = client.Ask(sk.AskRequest(
    soul_id=soul_id,
    session_token=init_resp.session_token,
    query="Hello from Python!"
))

# Print streaming response
for response in responses:
    if response.HasField('text_chunk'):
        print(response.text_chunk, end='')

const client = new SoulKernelClient('localhost:50051');

// Initialize and chat
const { soulId, sessionToken } = await client.init({ 
    soulName: 'WebSoul' 
});

const stream = client.ask({
    soulId,
    sessionToken, 
    query: 'Hello from the web!'
});

for await (const response of stream) {
    if (response.textChunk) {
        console.log(response.textChunk);
    }
}

# Make sure server is running, then:
cargo run --example demo_client --package grpc-server