https://github.com/oracle-devrel/askdata
Oracle AskData is a conversational AI platform powered by Oracle Generative AI. With AskData, you can ask natural language questions like "Give me all past due invoices" or "Show me sales for last week over $100,000" and get instant, accurate results.
https://github.com/oracle-devrel/askdata
chat-application generative-ai nl2sql oracle-cloud oracle-database trustworthy-ai
Last synced: about 12 hours ago
JSON representation
Oracle AskData is a conversational AI platform powered by Oracle Generative AI. With AskData, you can ask natural language questions like "Give me all past due invoices" or "Show me sales for last week over $100,000" and get instant, accurate results.
- Host: GitHub
- URL: https://github.com/oracle-devrel/askdata
- Owner: oracle-devrel
- License: upl-1.0
- Created: 2025-08-26T07:27:33.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-26T18:41:40.000Z (9 months ago)
- Last Synced: 2026-04-02T08:33:43.828Z (3 months ago)
- Topics: chat-application, generative-ai, nl2sql, oracle-cloud, oracle-database, trustworthy-ai
- Language: Python
- Homepage:
- Size: 38.3 MB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Security: SECURITY.md
- Notice: NOTICE.txt
Awesome Lists containing this project
README
# AskData NL2SQL Engine
[](https://img.shields.io/badge/license-UPL-green) [](https://sonarcloud.io/dashboard?id=oracle-devrel_test)
## Introduction
Oracle AskData is a conversational AI platform powered by Oracle Generative AI. With AskData, you can ask natural language questions like "Give me all past due invoices" or "Show me sales for last week over $100,000" and get instant, accurate results.
The solution empowers both non-technical users and SQL experts by simplifying complex queries and freeing up time for deeper analysis and decision-making.
## Getting Started
Please see the [Introduction](deployment-docs/docs/deployment/introduction.md) & [Architecture](deployment-docs/docs/deployment/architecture.md)
For policies see [Defining Policies](deployment-docs/docs/deployment/generic.md#dynamic-groups).
This solution is broken down into two separate apps, business and trust. It's recommended to start with the business app then build the trust app.
### Prerequisites
The CIS Landing Zone is optional but helps with providing a sandbox environment with best practices
- [Deploy CIS LZ](deployment-docs/docs/deployment/landing_zone.md)
This solution assumes you have access to an OCI tenancy with the admin ability to provision the following resources:
### Business App
#### Deployment Steps
1. [Deploy Business Database](deployment-docs/docs/deployment/database.md)
2. [Deploy Trust Database](deployment-docs/docs/deployment/database.md)
3. [Deploy Business IAM App](deployment-docs/docs/deployment/business_idcs.md)
4. [Deploy OCI Cache Cluster](https://docs.oracle.com/en-us/iaas/Content/ocicache/createcluster.htm#top)
5. [Deploy VCN](https://docs.oracle.com/en-us/iaas/Content/Network/Tasks/quickstartnetworking.htm#Virtual_Networking_Quickstart)
6. [Deploy Engine Documentation](deployment-docs/docs/deployment/nl2sql_engine.md)
7. [Deploy Vault](deployment-docs/docs/deployment/vault.md)
8. [Deploy Business API Gateway](deployment-docs/docs/deployment/business_api_gateway.md)
- (Optional) If deploying API Gateway privately, see [ADW API Gateway Private Access](deployment-docs/docs/deployment/adw_private_config.md)
9. [Deploy ODA](deployment-docs/docs/deployment/oda.md)
10. [Deploy VBCS](deployment-docs/docs/deployment/VBCS.md)
### Trust App
[Trust Service Overview](deployment-docs/docs/deployment/trust-service-overview.md)
#### Deployment Steps
1. [Deploy Trust VM](deployment-docs/docs/deployment/trust-service.c.md)
2. [Deploy IDCS/IAM APEX App](https://docs.oracle.com/en/learn/apex-identitydomains-sso/index.html#task-3-create-a-new-web-credential-in-your-oracle-apex-workspace)
- (Required) For IDCS security to the API Gateway, in addition to above configure the following:
- Client Credentials: Enabled
- Allowed operations: Introspect
3. [Deploy Trust API Gateway](deployment-docs/docs/deployment/trust-api-gateway.md)
4. [Deploy APEX](deployment-docs/docs/deployment/apex-trust.md)
- (Optional) For using a private ADW with APEX, see [Configure Private ADW ACL](deployment-docs/docs/deployment/apex-private-adw-lb.md)
- (Optional) If using a private ADW, see [Deploy Private ADB Load Balancer](deployment-docs/docs/deployment/apex-private-adw-lb.md)
### Validation
[Validation Testing](deployment-docs/docs/deployment/validation.md)
## Notes/Issues
See [Troubleshooting](deployment-docs/docs/deployment/troubleshooting.md)
## URLs
* Nothing at this time
## Contributing
This project welcomes contributions from the community. Before submitting a pull
request, please [review our contribution guide](./CONTRIBUTING.md).
## Security
Please consult the [security guide](./SECURITY.md) for our responsible security
vulnerability disclosure process.
## License
Copyright (c) 2024 Oracle and/or its affiliates.
Licensed under the Universal Permissive License (UPL), Version 1.0.
See [LICENSE](LICENSE.txt) for more details.
ORACLE AND ITS AFFILIATES DO NOT PROVIDE ANY WARRANTY WHATSOEVER, EXPRESS OR IMPLIED, FOR ANY SOFTWARE, MATERIAL OR CONTENT OF ANY KIND CONTAINED OR PRODUCED WITHIN THIS REPOSITORY, AND IN PARTICULAR SPECIFICALLY DISCLAIM ANY AND ALL IMPLIED WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. FURTHERMORE, ORACLE AND ITS AFFILIATES DO NOT REPRESENT THAT ANY CUSTOMARY SECURITY REVIEW HAS BEEN PERFORMED WITH RESPECT TO ANY SOFTWARE, MATERIAL OR CONTENT CONTAINED OR PRODUCED WITHIN THIS REPOSITORY. IN ADDITION, AND WITHOUT LIMITING THE FOREGOING, THIRD PARTIES MAY HAVE POSTED SOFTWARE, MATERIAL OR CONTENT TO THIS REPOSITORY WITHOUT ANY REVIEW. USE AT YOUR OWN RISK.