kzorluoglu's picture
Update README.md
15650a5 verified
---
license: apache-2.0
language:
- en
base_model:
- unsloth/gemma-2-9b-bnb-4bit
pipeline_tag: question-answering
tags:
- chameleon
- shop
- esono
---
# Chameleon-Code_Explation_Gemma29b-v3 - Draft
** Running Project - Draft*
Chameleon-Code_Explation_Gemma29b-v3 is a fine-tuned version of the Unsloth Gemma model, optimized for efficient inference using 4-bit quantization. This model has been trained to explain various classes within the Chameleon CMS system, which is a combined shop software and content management system.
## Table of Contents
- [Model Overview](#model-overview)
- [Getting Started](#getting-started)
- [Available Bundles](#available-bundles)
- [Available Classes](#available-classes)
- [Training Details](#training-details)
- [Evaluation](#evaluation)
- [Environmental Impact](#environmental-impact)
- [Technical Specifications](#technical-specifications)
- [Contact](#contact)
## Model Overview
Chameleon-Code_Explation_Gemma29b-v3 is a transformer-based language model fine-tuned to understand and explain the structure and components of the Chameleon CMS system. The model can provide non-technical descriptions of CMS components using efficient 4-bit quantization to minimize resource requirements.
- **Base Model:** Google Gemma 2 9B
- **Library Used:** PEFT
- **Language:** English
- **License:** Apache 2.0
- **Developer:** kzorluoglu
- **Model Source:** [Unsloth GitHub](https://github.com/unslothai/unsloth)
## Getting Started
To use the model, you can start by installing the necessary dependencies and downloading the model using the Hugging Face Transformers library.
### Installation
Install the `transformers` library:
```sh
pip install transformers
```
### Usage
Here is an example code snippet to get started:
```python
from transformers import AutoModel, AutoTokenizer
model = AutoModel.from_pretrained("kzorluoglu/Chameleon-Code_Explation_Gemma29b-v2")
tokenizer = AutoTokenizer.from_pretrained("kzorluoglu/Chameleon-Code_Explation_Gemma29b-v2")
print("Chatbot is ready!")
print("Type 'exit' to end the chat.")
print("Ask like this for a good answer:")
print("Explain the XYZ class. I don't want to see code, I want only the explanation.")
print("Explain the ABC bundle. I don't want to see code, I want only the explanation.")
while True:
question = input("You: ")
if question.lower() == 'exit':
print("Ending the chat. Goodbye!")
break
instruction = f"{question}"
inputs = tokenizer([instruction], return_tensors="pt").to("cuda")
outputs = model.generate(**inputs, max_new_tokens=256, use_cache=True)
generated_text = tokenizer.batch_decode(outputs, skip_special_tokens=True)
print(f"AI: {generated_text[0]}")
```
## Available Bundles
In addition to individual classes, the model has also been trained to explain a wide range of bundles within the Chameleon CMS system, including but not limited to:
* AmazonPaymentBundle
* ShopOrderStatusBundle
* ShopWishlistBundle
* ImageHotspotBundle
* ShopArticlePreorderBundle
* ShopCurrencyBundle
* ShopPaymentIPNBundle
* ShopAffiliateBundle
* ShopBundle
* ShopRatingServiceBundle
* SearchBundle
* ShopArticleReviewBundle
* ShopListFilterBundle
* ShopPaymentTransactionBundle
* ShopArticleDetailPagingBundle
* CmsEventBundle
* MediaManagerBundle
* ViewRendererBundle
* CmsCounterBundle
* UpdateCounterMigrationBundle
* CmsStringUtilitiesBundle
* ExternalTrackerBundle
* CookieConsentBundle
* CmsResultCacheBundle
* CmsActionPluginBundle
* CmsClassManagerBundle
* PkgCoreBundle
* ExtranetBundle
* CoreBundle
* CmsNavigationBundle
* JavaScriptMinificationBundle
* TrackViewsBundle
* CmsTextFieldBundle
* CmsCacheBundle
* AutoclassesBundle
* CmsChangeLogBundle
* DatabaseMigrationBundle
* Csv2SqlBundle
* NewsletterBundle
* DistributionBundle
* CmsFileManagerBundle
* SecurityBundle
* SnippetRendererBundle
* AtomicLockBundle
* TwigDebugBundle
To get the explanation for a specific class, use the prompt format:
```text
Explain the XYZ bundle. I don't want to see code, I want only the explanation.
```
## Available Classes
The model has been trained to provide explanations for a wide range of classes in the Chameleon CMS system, including but not limited to:
* MTFeedbackErrors
* AmazonDataConverter
* AmazonPaymentConfigFactory
* AmazonReferenceIdManager
* WebServerExample
* OffAmazonPaymentsNotifications_Samples_NotificationSample
* OffAmazonPaymentsNotifications_Samples_IpnLogFile
* SnsMessageValidator
* IpnNotificationParser
* XmlNotificationParser
* Message
* SnsMessageParser
* OffAmazonPayments_Model
* OffAmazonPaymentsService_Model
* OffAmazonPaymentsService_Regions
* OffAmazonPaymentsService_RegionSpecificProperties
* OffAmazonPaymentsService_Environments
* OffAmazonPaymentsService_MerchantValues
* OffAmazonPaymentsService_Model_ResponseHeaderMetadata
* CancellationExample
* CLIExample
* SimpleCheckoutExample
* AddressConsentSample
* SplitShipmentsCheckoutExample
* RefundExample
* AutomaticPaymentsSimpleCheckoutExample
* ShippingAndTaxCostHelper
* CountryRates
* AmazonPaymentFixturesFactory
* ConfigValidator
* AmazonPaymentIdMapping
* TPkgShopOrderStatusManagerEndPoint
* PkgShopWishlistMailHistory
* PkgShopWishlistArticle
* PkgShopWishlistOrderItem
* PkgShopWishlist
* PkgImageHotspotItemMarker
* PkgImageHotspot
* PkgImageHotspotItemSpot
* PkgImageHotspotItem
* UpdateProductStockListener
* ShopCurrencyEvents
* TPkgShopPaymentIPNManager
* TPkgShopPaymentIPNRequest
* TPkgShopPaymentIPN_TransactionDetails
* PkgShopPaymentIpnMessage
* PkgShopPaymentIpnTrigger
* PkgShopPaymentIpnStatus
* PkgShopPaymentIpnMessageTrigger
* PkgShopAffiliate
* PkgShopAffiliateParameter
* ShopEvents
* TShopCategoryTree
* MTShopArticleListResponse
* TShopBreadcrumbItem
* TShopBasketArticleCustomDataValidationError
* TdbShopArticle
* ShopPaymentHandlerMock
* BasketVariableReplacer
* UpdateProductStatisticsListener
* UpdateVariantParentStockListener
* UpdateProductStockListener
* OrderPaymentInfo
* ShopPaymentConfigRawValue
* ShopSystemPage
* PkgShopArticlePreorder
* Shop
* ShopShippingGroupHandler
* ShopShippingGroup
* ShopWrappingCard
* ShopCategoryTab
* PkgShopListfilterItem
* PkgShopStatisticGroup
* ShopVat
* PkgShopFooterCategory
* PkgShopListfilterModuleConfig
* ShopSuggestArticleLog
* ShopBankAccount
* ShopCategory
* ShopDiscount
* PkgShopPrimaryNavi
* ShopShippingType
* ShopWrapping
* PkgShopListfilterItemType
* PkgShopCurrency
* PkgShopListfilter
* ShopUserNoticeList
* ShopSystemInfoModuleConfig
* PkgShopArticleReviewModuleShopArticleReviewConfiguration
* ShopSystemInfo
* ShopPaymentHandlerGroup
* ShopPaymentMethod
* ShopPaymentHandlerGroupConfig
* ShopPaymentHandler
* ShopPaymentHandlerParameter
* ShopArticleCatalogConfDefaultOrder
* ShopStockMessageTrigger
* ShopVariantType
* ShopArticleImageSize
* ShopAttribute
* ShopBundleArticle
* ShopArticleDocumentType
* ShopArticleMarker
* ShopArticle
* ShopArticleImage
* ShopArticleReview
* ShopArticleCatalogConf
* ShopArticleContributor
* ShopArticleDocument
* ShopVariantSet
* ShopStockMessage
* ShopArticleType
* ShopVariantDisplayHandler
* ShopUnitOfMeasurement
* ShopArticleStats
* ShopAttributeValue
* ShopVariantTypeHandler
* ShopContributorType
* ShopContributor
* ShopVariantTypeValue
* ShopManufacturerModuleConf
* ShopArticleStock
* ShopArticlePreviewImage
* ShopManufacturer
* ShopArticleGroup
* ShopVoucherUse
* ShopVoucherSeriesSponsor
* ShopUserPurchasedVoucher
* ShopVoucherSeries
* ShopVoucher
* ShopModuleArticleListArticle
* ShopModuleArticlelistOrderby
* ShopModuleArticleList
* ShopModuleArticleListFilter
* ShopOrderBasket
* ShopOrder
* ShopOrderStatusCode
* ShopOrderExportLog
* ShopOrderStatusItem
* ShopOrderStatus
* ShopOrderVat
* ShopOrderShippingGroupParameter
* ShopOrderItem
* ShopOrderStep
* ShopOrderBundleArticle
* ShopOrderPaymentMethodParameter
* ShopOrderDiscount
* SearchSuggestController
* XmlStreamer
* TShopAuskunftAPI
* PkgShopRatingServiceRating
* PkgShopRatingServiceTeaserCnf
* PkgShopRatingServiceWidgetConfig
* PkgShopRatingServiceHistory
* PkgShopRatingService
* TShopModuleArticleListFilterAutoParent
* TdbShopModuleArticleListFilter
* SearchResultTriggerCmsObserverListener
* SearchResultLoggerListener
* ShopSearchFieldWeight
* ShopSearchCloudWord
* ShopSearchCache
* ShopSearchQuery
* ShopSearchCacheItem
* ShopSearchIndexer
* ShopSearchKeywordArticle
* ShopSearchLog
* ShopSearchIgnoreWord
* AuthorDisplayConstants
* Slider
* Select
* DbAdapter
* TPkgShopPaymentTransactionItemDataEndPoint
* TPkgShopPaymentTransactionManagerEndPoint
* TPkgShopPaymentTransactionContextEndPoint
* PkgShopPaymentTransactionPosition
* PkgShopPaymentTransactionType
* PkgShopPaymentTransaction
* AddParametersToUrlService
* CacheUtil
* TPkgCmsEventManager
* DeleteMediaConnectionsListener
* ViewRenderer
* TPkgViewRendererMapper_ListHandlerData
* TPkgViewRendererLessCompiler
* TPkgViewRendererSnippetResourceCollectorEndPoint
* TPkgViewRendererSnippetDummyData
* TPkgViewRendererSnippetGalleryItem
* MapperVirtualSourceObject
* User
* Article
* GenerateCssController
* CmsCounter
* UpdateCounterMigrator
* UpdateCounterVersionMigrator
* MigrationConfigGenerator
* MigrateCountersListener
* TPkgCmsStringUtilities_HTML
* TPkgCmsStringUtilities_ReadConfig
* TPkgCmsStringUtilities_CleanPHPCode
* TPkgCmsStringUtilities_iOSMailURLEncoder
* TPkgCmsStringUtilities_PathUtils
* SearchResultTriggerCmsObserverListener
* CategoryTriggerCmsObserverListener
* AddCookieConsentIncludesListener
* TPkgCmsResultCacheManager
* TPkgCmsActionPluginManager
* AbstractPkgActionPlugin
* TPkgCmsVirtualClassManager
* TPkgCmsCoreSendToHost
* TPkgCoreUtility_Network
* TPkgCmsCoreLayoutPluginManager
* TPkgCmsCoreParameterContainerParameterDefinition
* AbstractPkgCmsCoreParameterContainer
* ExtranetEvents
* ExtranetUserConstants
* RefreshAuthenticityTokenListener
* RehashPasswordListener
* DelayFailedLoginAttemptListener
* LoginByTokenController
* ServiceLocator
* CoreEvents
* CronJobScheduleDataModel
* chameleon
* TableConfigurationDataModel
* CmsMasterPagdef
* DownloadLinkDataModel
* PagePath
* File
* Error
* UploaderController
* UploaderParametersDataModel
* UploadedFileDataModel
* StripVirtualFieldsFromQuery
* CronJobThatDoesNotExtendTCMSCronJob
* HtmlHelper
* TGlobalBase
* TModuleLoader
* TModelBase
* MTCustomListCoreConfig
* TTemplateTools
* TCMRenderMediaTreeSelectBox
* TCMSRegistry
* TCMSSmartURL
* TCMSTidyHTMLCleaner
* TCMSLockManager
* TCMSURLHistory
* TCMSRssHandler
* TCMSRender
* TPkgDependencyInjection
* TCMSLogChange
* TCMSViewPortManager
* TCMSRenderSeoPattern
* TCMSPageDefinitionFile
* TCMSRenderDocumentTreeSelectBox
* FalseValueCacheEntry
* TCMSMemcache
* TCMSTreeWidget
* TCMSTableToClass_MockRecord
* TCMSTableToClass
* TCacheManagerRuntimeCache
* TViewParser
* TCMSSmartURLData
* TCMSSmartURLHandler
* TCMSParameterMapperEndPoint
* TCMSMenuItem
* TCMSSpellcheck
* MTFeedbackErrorsCore
* TCMSErrorHandler
* MySqlLegacySupport
* TCMSFile
* TDbChangeLogManagerForModules
* TCMSTableEditorManager
* TCMSTableEditorEndPoint
* TCMSTableEditorMenuItem
* TCMSMessageManager
* TCMSImageEndpoint
* THTMLTable
* THTMLTableColumn
* HtmlParser
* TGoogleMapMarker
* TGoogleOverviewMap
* TGoogleMapEndPoint
* TGoogleMapIcon
* TCMSBreadcrumbNavi
* TCMSBreadcrumbNaviItem
* TGroupTableField
* TGroupTable
* TGroupTableStyle
* TPkgRunFrontendActionStatus
* TCMSGroupedStatistics
* TCMSGroupedStatisticsGroup
* TCCustomNavigation
* SQLParser
* SQLParenthesesParser
* imageMagick
* antiSpam
* TPkgCmsSessionWakeUpService
* TCMSListManagerEndPoint
* TCMSUserInput
* TCMSUserInputFilter_BaseClass
* TCMSUpdateManager
* TTools
* CheckPortalDomainListener
* CaseInsensitivePortalExceptionListener
* TemplateEngineAccessListener
* AddAntispamIncludesListener
* BackendBreadcrumbListener
* AddControllerIncludesListener
* CleanupBreadcrumbAfterDeleteListener
* RedirectToSecurePageListener
* ClearRoutingCacheListener
* InitializeRequestListener
* ReleaseOldLocksOnLoginListener
* AddGlobalHeadIncludesListener
* MigrateSessionListener
* AddModuleIncludesListener
* ChangeChameleonObjectsLocaleListener
* AddBackendToasterMessageListener
* NoCacheForSecurePageListener
* RehashBackendUserPasswordListener
* AllowEmbeddingForDifferentDomainListener
* AddJqueryIncludeListener
* BackendTreeNodeFactory
* RequestInitializer
* FieldTranslationUtil
* UrlUtil
* MltFieldUtil
* UrlNormalizationUtil
* AbstractDatabaseAccessLayer
* TranslationConstants
* JsTranslationController
* ModuleIconMigrator
* MainMenuMigrator
* IconMapping
* MenuItem
* MenuCategory
* ChameleonControllerEvents
* ImageNotFoundController
* BackendAccessCheck
* CsrfTokenManagerFactory
* Migrator
* ComposerData
* ComposerJsonModifier
* AbstractPkgCmsNavigationNode
* JavaScriptMinifyEventListener
* ImageCropPresetDataModel
* ImageCropDataModel
* ImageDataModel
* CmsMediaDataModel
* TPkgTrackObjectViews
* TrackViewsListener
* TCMSTextFieldEndPoint
* TdbCmsLanguage
* RequestListener
* AutoClassLoader
* MappingDataModel
* DataModelParts
* name
* MediaItemChainUsageFinder
* SortColumnCollection
* MediaItemUsageChainDeleteService
* MediaManagerExtensionCollection
* MediaManagerListResult
* MediaManagerListRequest
* AccessRightsModel
* MediaManagerListState
* MediaTreeDataModel
* MediaItemUsageDataModel
* MediaTreeNodeDataModel
* MediaItemDataModel
* JavascriptPluginRenderedContent
* JavascriptPluginMessage
* JavascriptPluginConfigurationState
* JavascriptPluginConfigurationUrls
* JavascriptPluginConfiguration
* MediaTreeNodeJsonObject
* TCMSChangeLogArchiver
* TCMSChangeLogFormatter
* SnippetChainModifier
* MigrationRecorderStateHandler
* MigrationRecorder
* QueryWriter
* DataModelConverter
* TPkgCsv2SqlManager
* NewsletterPostProcessorListener
* NewsletterUserDataModel
* PostUpdateVersionCheck
* ChameleonVersion
* MatchLevel
* InitialBackendUserCreator
* TPkgCmsFileManager_Utilities
* RedirectOnPendingUpdatesEventListener
* SecurityHelperAccess
* CmsUserRoleConstants
* CmsPermissionAttributeConstants
* CmsUserSSOModel
* TPkgSnippetRenderer_PregCallbackHelper
* TPkgSnippetRenderer_ResourceHelper
* TPkgSnippetRendererFilter
* AtomicLock
* ViewRendererPostRenderListener
* LogChangeDataModel
* MigrationDataModel
* MigrationQueryData
* MigrationRecorderConstants
* QueryConstants
* DatabaseMigrationConstants
* MigrationDataModelReducer
*
To get the explanation for a specific class, use the prompt format:
```text
Explain the XYZ class. I don't want to see code, I want only the explanation.
```
## Training Details
### Training Data
The model was trained on data from the following sources:
- [Chameleon Shop System](https://github.com/chameleon-system/chameleon-shop)
- [Chameleon System](https://github.com/chameleon-system/chameleon-system)
- [Chameleon Base](https://github.com/chameleon-system/chameleon-base)
### Training Procedure
- **Training Type:** Mixed precision (fp16) with 4-bit quantization
- **Prompt Format:** The model is trained to respond to prompts such as:
```text
Explain the XYZ class. I don't want to see code, I want only the explanation.
Explain the ABC bundle. I don't want to see code, I want only the explanation.
```
## Evaluation
The model was evaluated using specific Chameleon CMS classes to ensure accurate and useful explanations.
- **Metrics Used:**
- **Perplexity**: Evaluated for language modeling capabilities.
- **Accuracy**: Assessed based on how well the model explains Chameleon CMS components.
### Results
The model demonstrated good accuracy in explaining the components of Chameleon CMS, providing clear and detailed answers.
## Environmental Impact
- **Hardware Type:** Tesla T4 GPU
- **Training Hours:** 10 hours
- **Cloud Provider:** Google Cloud (US Central)
- **Estimated Carbon Emission:** 5 kg CO2eq
## Technical Specifications
- **Model Architecture:** Transformer-based model with 4-bit quantization.
- **Compute Infrastructure:**
- Hardware: Tesla T4 GPU
- Software: PyTorch 2.4.1, CUDA 12.1
## Contact
For any questions or issues, you can reach out to:
- **Email:** [hello@d8devs.com](mailto:hello@d8devs.com)
## License
The model is available under the Apache 2.0 License.
## Citation
If you use this model, please cite it as follows:
```bibtex
@misc{kzorluoglu2024chameleon,
author = {kzorluoglu},
title = {Chameleon-Code_Explation_Gemma29b-v3},
year = {2024},
url = {https://github.com/kzorluoglu},
note = {Apache 2.0 License}
}
```