Introduction#

AIScript is a unique combination of interpreter programming language and web framework, both written in Rust, designed to help developers build AI applications effortlessly. The language syntax draws inspiration from Python, JavaScript, and Rust, combining their strengths to create something that's intuitive, powerful, and easy to use.

Programming Language#

As a programming language, AIScript is built with a custom interpreter from the ground up:

• Functions are first-class citizens with support for object-oriented programming paradigms
• Built-in AI primitives, including prompt, AI functions, and agent capabilities
• Dynamic typing system with targeted static type checking for improved safety
• Built-in data validation similar to Python's Pydantic
• Simple yet powerful error handling, inspired by Rust, Go, and Zig
• Rich standard library leveraging Rust's ecosystem underneath
• Automatic garbage collection for memory management

Web Framework#

AIScript isn't just a language—it's a complete web development solution:

• Elegant and intuitive route DSL for defining endpoints
• Automatic parameter validation with clear error messages
• Automatic OpenAPI schema and documentation generation
• Built on Rust's best practices, using axum and sqlx under the hood
• Combines Rust's axum performance with Python's Flask-like simplicity
• Built-in database modules (std.db.pg and std.db.redis)
• Built-in authentication and social login capabilities
• Battery-included features easily enabled through simple configuration

How AIScript works#

$ export OPENAI_API_KEY=<your-openai-api-key>
$ cat web.ai
get / {
    """An api to ask LLM"""

    query {
        """the question to ask"""
        @string(min_len=3, max_len=100) // validate params with builtin directive @string
        question: str
    }

    // `ai` and `prompt` are keywords
    ai fn ask(question: str) -> str {
        let answer = prompt question;
        return answer;
    }
    // use query.name or query["name"] to access query parameter
    let answer = ask(query.question);
    return { answer };
}

$ aiscript serve web.ai
Listening on http://localhost:8080

$ curl http://localhost:8080
{
    "error": "Missing required field: question"
}

$ curl http://localhost:8080?question=Hi
{
    "error": "Field validation failed: question: String length is less than the minimum length of 3"
}

$ curl http://localhost:8080?question=What is the capital of France?
{
    "answer": "The capital of France is Paris."
}

You can open http://localhost:8080/redoc to see the automatically generated API documentation.

Use Cases#

AIScript excels in these scenarios:

• AI-powered APIs: When you need to build APIs that leverage LLMs and other AI services
• Prototyping: Rapidly build and test ideas without configuration overhead
• Microservices: Create lightweight, focused services with minimal boilerplate
• Data validation: When request/response validation is critical to your application
• Internal tools: Build tools quickly with integrated documentation

Philosophy#

AIScript embraces these core principles:

• Convention over configuration: Sensible defaults that work out of the box
• Progressive complexity: Easy to get started, powerful when you need it
• AI-native design: Built from the ground up for the age of AI
• Developer happiness: Focusing on the developer experience first
• Performance without sacrifice: No need to choose between speed and productivity