README.md

AIScript

The next generation language for human and AI.

https://aiscript.dev

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.

Warning

AIScript is in early development. Please do not use it in production yet.

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

Examples

Check out the examples directory for more sample code.

Roadmap

See our roadmap for upcoming features and improvements.

Contributing

We welcome contributions to AIScript! Please see our Contribution Guide for more information.

License

AIScript is released under the MIT License. See LICENSE for details.